大网数据广告活动
Web 标准与前端开发

Document:startViewTransition() 方法

· 52CE 我爱测

View Transitions API 的 **`startViewTransition()`** 方法开始一个新的视图过渡,并返回一个 ViewTransition 对象来表示它。

Document

View Transitions API 的 startViewTransition() 方法开始一个新的视图过渡,并返回一个 ViewTransition 对象来表示它。

当调用 startViewTransition() 时,将按照视图过渡过程中所述的步骤序列进行。

语法

startViewTransition(callback)

参数

  • callback
    • : 一个在视图过渡过程中通常用于更新 DOM 的回调函数,它返回一个 Promise。这个回调函数在 API 截取了当前页面的屏幕截图后被调用。当回调函数返回的 Promise 兑现时,视图过渡将在下一帧开始。如果回调函数返回的 Promise 拒绝,过渡将被放弃。

返回值

一个 ViewTransition 对象实例。

示例

基本用法

在基础视图过渡演示中,updateView() 函数处理支持和不支持 View Transitions API 的浏览器。在支持的浏览器中,我们调用 startViewTransition() 来启动视图过渡,而不关心返回值。

function updateView(event) {
  // 处理在 <a> 或 <img> 上触发事件的差异
  let targetIdentifier;
  if (event.target.firstChild === null) {
    targetIdentifier = event.target;
  } else {
    targetIdentifier = event.target.firstChild;
  }

  const displayNewImage = () => {
    const mainSrc = `${targetIdentifier.src.split("_th.jpg")[0]}.jpg`;
    galleryImg.src = mainSrc;
    galleryCaption.textContent = targetIdentifier.alt;
  };

  // 浏览器不支持 View Transitions 时的回退方案:
  if (!document.startViewTransition) {
    displayNewImage();
    return;
  }

  // 开始一次视图过渡:
  const transition = document.startViewTransition(() => displayNewImage());
}

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。