Menu

ViewTransition

viewTransition 是一个实验性标志,用于在 React 中启用新的实验性 View Transitions API。此 API 允许你利用原生 View Transitions 浏览器 API 创建 UI 状态之间的无缝过渡。

要启用此功能,你需要在 next.config.js 文件中将 viewTransition 属性设置为 true

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    viewTransition: true,
  },
}
 
module.exports = nextConfig

重要提示:此功能不是由 Next.js 团队开发或维护的——它是来自 React 团队的实验性 API。它仍处于早期阶段不建议在生产环境中使用。该实现仍在迭代中,其行为可能在未来的 React 版本中发生变化。 启用此功能需要理解 API 的实验性质。要完全理解其行为,请参考 React pull request 和相关讨论。

用法

启用后,你可以在应用程序中从 React 导入 ViewTransition 组件:

import { unstable_ViewTransition as ViewTransition } from 'react'

然而,目前文档和示例有限,你需要直接参考 React 的源代码和讨论以了解它的工作原理。

在线演示

查看我们的 Next.js View Transition 演示 以了解此功能的实际效果。

随着此 API 的发展,我们将更新文档并分享更多示例。但是,目前,我们强烈建议不要在生产环境中使用此功能。