View Transitions 使用指南

更新于 2025年12月28日

View Transitions 使用指南

本项目已启用 Astro View Transitions,提供平滑的页面切换体验。

<ClientRouter />

启用视图过渡动画(SPA 模式) 导入 <ClientRouter /> 组件并将其添加到公共 <head> 或共享布局组件中。Astro 将根据旧页面和新页面之间的相似之处创建默认的页面动画,并为不支持的浏览器提供回退行为。 》 这带来了一些好处,比如跨页面的共享状态和持久化元素,也有一些缺点,例如在导航后需要手动重新初始化脚本或状态。

然而,随着浏览器 API 和 web 标准的不断发展,使用 Astro 的 <ClientRouter /> 来实现这些附加功能 将越来越变得不必要。我们建议你关注浏览器 API 的当前状态,以便你可以根据你使用的特定功能决定是否仍然需要 Astro 的客户端路由。

遇到问题

遇到一个问题 我的 <auth/> 组件在第一次加载时会加载,但是页面切换后不会加载,马上就锁定到是 平滑的页面切换体验 的问题,查了官网

<div
  id="auth"
  transition:persist
></div>