View Transitions API 仅对已挂载且可匹配的 DOM 元素生效,依赖成对、稳定、唯一的 view-transition-name 属性触发快照过渡,不支持跨页面导航或异步 DOM 更新。
View Transitions API 不是“把 HTML 字符串转成过渡效果”的工具,它只对已挂载、可匹配的 DOM 元素生效。直接
后调用
,大概率没动画——因为旧元素已被销毁,快照捕获失败。
startViewTransition 回调里只能写同步 DOM 更新
浏览器在回调执行前拍一次快照,执行完再拍一次,中间必须是**立即可见的 DOM 变更**。任何
、
、
套在外面都会导致快照错位。
❌ 错误:在回调外等数据,再更新 DOM
✅ 正确:先取数据,再进回调同步写入
⚠️ 注意:如果
是空容器或刚创建,确保它已在 document 中(不能是
后还没 append)
view-transition-name 必须成对、稳定、唯一
过渡是否触发,90% 取决于这个属性是否配对成功。它不是 class,不是 id,是独立的 CSS 属性,靠值精确匹配。
旧元素和新元素都得有
,且值完全一致(大小写敏感)
值不能是空、
或动态生成(比如
但前后
不一致)
不要给非目标元素乱加该属性,否则它们也会被卷入过渡,干扰动画层叠
推荐写法:
→ 新 DOM 中同样位置也带
过渡卡顿或闪烁,大概率是样式触发了不可见快照
View Transition 依赖合成层快照,以下 CSS 会让浏览器无法捕获旧元素视觉状态:
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
下载
立即学习
“
前端免费学习笔记(深入)
”;
、
、
等隐藏类若在快照前已生效,旧元素就“不可见”,动画只剩新元素淡入
解决办法:过渡开始前,确保待动画元素处于可见、可绘制状态(哪怕只是
)
不要在
调用前给元素加
或移除它;如需 loading 状态,用占位结构或透明遮罩,别动目标元素本身
检查 DevTools 的 Layers 面板,确认过渡元素是否进入了独立合成层(
可辅助,但非必需)
多页应用(MPA)中无法直接使用 View Transition
View Transition 只响应同一文档内 DOM 的变更,不接管跨页面导航。用户点链接跳转到新 HTML 文件时,旧页面已卸载,API 无从介入。
✅ 可行方案:改用 SPA 模式,用
+ 手动 DOM 替换 +
❌ 不可行方案:在
或
里调用
,此时没有“旧视图”可捕获
替代思路(MPA 场景):监听
事件做轻量级 CSS 过渡,或用
配合自定义 fade 动画
最易忽略的一点:过渡动画是否生效,和 JS 是否报错无关。
静默失败很常见——元素没匹配上、name 写错、DOM 未挂载、甚至只是用了
却没清空旧子节点导致结构错位。建议先用最简 case 验证:两个带相同
的
document.body.innerHTML = htmlStringstartViewTransitionawaitsetTimeoutfetch().then()const res = await fetch('/post');document.startViewTransition(() => { article.innerHTML = res.text(); }); // res.text() 是 Promise,不是字符串fetch('/post').then(r => r.text()).then(html => { document.startViewTransition(() => { article.innerHTML = html; });});articledocument.createElement('div')view-transition-name: titlenoneview-transition-name: item-${id}id旧标题
style="view-transition-name: title"transform: scale(0)opacity: 0visibility: hiddenopacity: 0.999startViewTransitiondisplay: nonewill-change: transformhistory.pushState()startViewTransitionwindow.onloadDOMContentLoadedstartViewTransitionpageswapdocument.visibilityStatestartViewTransitioninnerHTMLview-transition-name
,手动切换 innerHTML,再逐步加逻辑。
