View Transitions API 仅对已挂载且可匹配的 DOM 元素生效,依赖成对、稳定、唯一的 view-transition-name 属性触发快照过渡,不支持跨页面导航或异步 DOM 更新。

View Transitions API 不是“把 HTML 字符串转成过渡效果”的工具,它只对已挂载、可匹配的 DOM 元素生效。直接 document.body.innerHTML = htmlString 后调用 startViewTransition,大概率没动画——因为旧元素已被销毁,快照捕获失败。
startViewTransition 回调里只能写同步 DOM 更新
浏览器在回调执行前拍一次快照,执行完再拍一次,中间必须是**立即可见的 DOM 变更**。任何 await、setTimeout、fetch().then() 套在外面都会导致快照错位。
- ❌ 错误:在回调外等数据,再更新 DOM
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; });});- ⚠️ 注意:如果
article是空容器或刚创建,确保它已在 document 中(不能是document.createElement('div')后还没 append)
view-transition-name 必须成对、稳定、唯一
过渡是否触发,90% 取决于这个属性是否配对成功。它不是 class,不是 id,是独立的 CSS 属性,靠值精确匹配。
- 旧元素和新元素都得有
view-transition-name: title,且值完全一致(大小写敏感) - 值不能是空、
none或动态生成(比如view-transition-name: item-${id}但前后id不一致) - 不要给非目标元素乱加该属性,否则它们也会被卷入过渡,干扰动画层叠
- 推荐写法:
→ 新 DOM 中同样位置也带旧标题
style="view-transition-name: title"
过渡卡顿或闪烁,大概率是样式触发了不可见快照
View Transition 依赖合成层快照,以下 CSS 会让浏览器无法捕获旧元素视觉状态:
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
-
transform: scale(0)、opacity: 0、visibility: hidden等隐藏类若在快照前已生效,旧元素就“不可见”,动画只剩新元素淡入 - 解决办法:过渡开始前,确保待动画元素处于可见、可绘制状态(哪怕只是
opacity: 0.999) - 不要在
startViewTransition调用前给元素加display: none或移除它;如需 loading 状态,用占位结构或透明遮罩,别动目标元素本身 - 检查 DevTools 的 Layers 面板,确认过渡元素是否进入了独立合成层(
will-change: transform可辅助,但非必需)
多页应用(MPA)中无法直接使用 View Transition
View Transition 只响应同一文档内 DOM 的变更,不接管跨页面导航。用户点链接跳转到新 HTML 文件时,旧页面已卸载,API 无从介入。
- ✅ 可行方案:改用 SPA 模式,用
history.pushState()+ 手动 DOM 替换 +startViewTransition - ❌ 不可行方案:在
window.onload或DOMContentLoaded里调用startViewTransition,此时没有“旧视图”可捕获 - 替代思路(MPA 场景):监听
pageswap事件做轻量级 CSS 过渡,或用document.visibilityState配合自定义 fade 动画
最易忽略的一点:过渡动画是否生效,和 JS 是否报错无关。startViewTransition 静默失败很常见——元素没匹配上、name 写错、DOM 未挂载、甚至只是用了 innerHTML 却没清空旧子节点导致结构错位。建议先用最简 case 验证:两个带相同 view-transition-name 的
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










