跳到主要内容

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 的发展,我们将更新文档并分享更多示例。但是,目前我们强烈建议不要在生产环境中使用此功能。