结论先行:View Transitions(视图过渡)让浏览器在「旧状态」和「新状态」之间自动截图并做动画,同文档过渡用 document.startViewTransition() 触发,跨文档过渡只需两个页面都声明 @view-transition { navigation: auto; }。截至 2026 年 11 月,同文档过渡已在三大引擎可用(Chrome 111+、Safari 18+、Firefox 144+,2025 年 10 月进入 Baseline);跨文档过渡 Chrome 126+、Safari 18.2+ 支持,Firefox 尚未实现,属于典型的渐进增强场景:不支持的浏览器直接正常跳转,功能零损失。本文给出两种模式的完整落地代码、共享元素动画、方向感知与降级策略。
视图过渡到底替你做了什么
传统页面切换动画要自己截图、自己盖层、自己跑贝塞尔曲线,还要处理滚动位置、固定定位元素和动画期间的交互屏蔽,工程量不小且极易与路由状态不同步。View Transitions 把这套流程标准化了:浏览器先给当前页面(或指定元素)拍一张快照,然后执行 DOM 更新或页面导航,再给新状态拍一张快照,最后把新旧快照放进一组伪元素里,用 CSS 动画完成过渡。整个过程中真实 DOM 只更新一次,动画发生在合成层,不阻塞主线程逻辑。
关键心智模型是「快照树」:根快照叫 root,任何设置了唯一 view-transition-name 的元素会额外生成独立快照,浏览器按名字把新旧两个元素配对,自动完成位置、尺寸的插值。这就是「列表缩略图放大成详情页头图」这类共享元素动画的原理——你不需要记录坐标,只需要让两个页面上的对应元素叫同一个名字。
同文档过渡:SPA 的标准接法
单页应用里,把 DOM 更新包进 startViewTransition 的回调即可。回调可以是同步函数,也可以返回 Promise,浏览器会等更新完成再拍新快照。不支持的浏览器没有这个方法,直接执行更新就是完美降级:
function navigate(updateFn) {
if (!document.startViewTransition) {
updateFn();
return;
}
document.startViewTransition(() => updateFn());
}::view-transition-old(root) {
animation: fade-out 200ms ease-out both;
}
::view-transition-new(root) {
animation: fade-in 300ms ease-in both;
}
@keyframes fade-out { to { opacity: 0; } }
@keyframes fade-in { from { opacity: 0; } }默认效果是整页交叉淡化。想更克制,可以只给主内容区命名,让导航栏和底部标签栏保持静止:给 main 设置 view-transition-name: content,再针对 ::view-transition-old(content) 与 ::view-transition-new(content) 写滑入滑出动画。注意名字必须全局唯一,同一时刻两个元素叫同一个名字会导致过渡被跳过,列表场景要么只给「被点击的那一项」临时命名,要么使用较新的 match-element 值按元素身份自动配对(支持面更窄,以官方为准)。
跨文档过渡:MPA 的两行开关
多页应用不需要任何 JavaScript 触发。只要导航是同源的,且新旧两个页面都在 CSS 里声明了选择启用,浏览器就会在导航时自动过渡:
@media (prefers-reduced-motion: no-preference) {
@view-transition {
navigation: auto;
}
}
::view-transition-old(root) {
animation: 0.3s ease-in both slide-out;
}
::view-transition-new(root) {
animation: 0.3s ease-out both slide-in;
}
@keyframes slide-out { to { transform: translateX(-20%); opacity: 0; } }
@keyframes slide-in { from { transform: translateX(100%); } }把这段放进两个页面共享的全局样式表即可。auto 覆盖的导航类型是 traverse(前进后退)以及由用户与页面内容交互发起的 push/replace;地址栏输入、书签、刷新不会触发。导航耗时过长(Chrome 中超过 4 秒)会跳过过渡直接展示新页面,所以过渡不是加载遮罩,别指望它掩盖慢接口。跨源导航一律不生效,这是安全边界,不是配置问题。
共享元素:列表到详情的形变
电商场景最有价值的用法是商品卡片到详情页的连续过渡。列表页给被点击商品的图片和标题命名,详情页给头图和标题同样的名字,浏览器自动完成「小图飞到大图」的形变。跨文档模式下可以用 pageswap 与 pagereveal 两个事件动态命名:pageswap 在旧页面最后一帧渲染前触发,适合给被点击的卡片临时设置 view-transition-name;pagereveal 在新页面首次渲染前触发,适合给详情页对应元素命名。两个事件都挂在 window 上,事件对象的 viewTransition 属性存在即说明本次导航会发生过渡。过渡结束后记得把名字清掉(await viewTransition.finished 或 ready 之后置空),否则返回导航或 BFCache 恢复时会残留命名,影响下一次过渡。配合 navigation.activation 提供的来源与目标历史记录信息,还能判断「进入详情」还是「返回列表」,分别套用方向相反的动画。
类型与无障碍
过渡类型(types)让同一套页面按场景切换动画:分页前进用左滑、后退用右滑。跨文档可以在 @view-transition 里写 types: slide, forwards;,或在 pagereveal 里动态 e.viewTransition.types.add(...),CSS 侧用 :active-view-transition-type(forwards) 选择器分别定义动画,类型在过渡结束后自动清理,不需要手动复位类名。无障碍方面有两件事必须做:一是把 @view-transition 声明包在 prefers-reduced-motion: no-preference 媒体查询里,尊重减少动态效果的用户;二是为快照伪元素准备 reduce 分支,把动画时长压到接近零。过渡期间浏览器会屏蔽页面交互,动画时长建议控制在 200 到 400 毫秒,过长会让用户觉得页面「卡住了」。
与路由框架的集成
SPA 框架集成视图过渡的关键是找到「DOM 更新发生在哪一刻」。React 项目可以把状态更新包进 startViewTransition 的回调,注意回调里的 setState 触发的渲染要同步完成后再返回,必要时使用 flushSync;Vue 项目可以在路由切换的钩子里包裹 nextTick 后的更新;原生路由拦截则统一走一个 navigate 封装。框架的并发渲染与过渡回调的时序是主要坑点:回调返回后浏览器立即拍新快照,如果此时框架还没把 DOM 更新完,快照拍到的就是旧状态。跨文档模式与框架无关,是服务端渲染多页站点的免费午餐。另外要处理 BFCache:页面从缓存恢复时不会重新触发 pagereveal 的完整流程,临时命名务必在过渡结束后清理,否则恢复的页面带着残留名字,下一次导航就会冲突。
兼容与降级策略
同文档过渡:Chrome/Edge 111+、Safari 18+、Firefox 144+,2025 年 10 月成为 Baseline Newly Available,覆盖面已经相当广,但调用前仍要检测 document.startViewTransition 是否存在。跨文档过渡:Chrome/Edge 126+、Safari 18.2+,Firefox 截至 2026 年 11 月尚未支持,@view-transition 规则会被当作未知 at-rule 安静忽略,页面照常跳转,这正是它适合渐进增强的原因。JavaScript 侧可以用 'onpagereveal' in window 粗判跨文档能力。降级原则只有一条:过渡是装饰层,删掉所有相关代码后站点必须完全可用;不要为了等过渡而延迟真实导航,也不要用 blocking=render 长时间阻塞首屏来「配合动画」,那会伤害核心 Web 指标。
结合 api工厂:商城列表到详情的质感升级
商品列表到详情是视图过渡的最佳落地场景。以 api工厂(https://www.it120.cc/)为例,商品、Banner、文章内容都由现成管理后台维护,H5 商城通过 SDK 拉取数据渲染列表与详情;开源前端项目 vueMinishop、wechat-app-mall、uni-app-mall(大全见 https://www.it120.cc/help/uq920k.html)提供了完整的列表页与详情页结构,你只需要在两端给商品主图设置一致的 view-transition-name,就能以极低成本获得接近原生 App 的转场质感。数据层不用动,路由不用动,改的只是几行 CSS 和两个事件监听。对多页形态的官网加商城混合站点,跨文档的两行开关尤其划算:不支持的浏览器无感,支持的浏览器体验直接上一个台阶。
快照树与伪元素结构
理解伪元素层级是自定义动画的前提。每次过渡会生成一棵快照树:根节点是 ::view-transition,其下每个命名快照对应一个 ::view-transition-group(name),group 内部又包含 ::view-transition-image-pair(name),pair 里才是真正承载像素的 ::view-transition-old(name) 与 ::view-transition-new(name)。group 负责位置与尺寸的插值动画,old 与 new 负责各自的淡入淡出或滑动。想改「飞行轨迹」的时长与缓动,写 group;想改「旧页面如何消失、新页面如何出现」,写 old 与 new。默认根快照 root 永远存在,即使你一个名字都没声明,整页交叉淡化也照常工作。多个快照共享动画参数时,可以用 view-transition-class 给一组元素打共用标签,再用 ::view-transition-group(.card) 一条规则统一设置,避免为每个名字重复写样式。这套结构初看繁琐,但职责划分非常清晰,调试时在开发者工具里能直接看到快照树,定位问题比手写覆盖层动画容易得多。
常见失效清单
视图过渡「没生效」的原因高度集中,按这份清单排查可以省大量时间。第一,名字冲突:同一时刻两个元素使用了同一个 view-transition-name,浏览器会直接跳过整个过渡,列表场景务必只给唯一元素命名。第二,跨文档条件不满足:两个页面必须同源、都声明了 @view-transition,且导航类型在 auto 覆盖范围内,缺一个都静默降级。第三,回调里做了异步长任务:同文档过渡会等回调的 Promise 完成才拍新快照,接口太慢会让旧页面「定格」,建议先更新骨架再填数据。第四,动画期间元素被移除或 display: none,快照捕获失败。第五,忘了清理临时命名,返回导航时残留名字引发冲突。第六,把过渡当成加载状态使用,导航超过超时阈值后过渡被跳过,用户看到的仍是白屏——加载体验要单独设计。
性能与度量
过渡动画本身跑在合成层,成本可控,但快照捕获需要渲染整页,页面越复杂捕获越贵。建议只给真正需要形变的元素命名,而不是给每个区块都起名;快照数量上去之后,内存与捕获时间都会明显增长。动画时长控制在 200 到 400 毫秒,既保证质感又不拖慢交互节奏。上线后可以用 Navigation Timing 与自定义埋点对比启用前后的跳出率与详情页到达率,把「质感升级」变成可度量的收益,而不是凭感觉的装饰。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。