mirror of
https://github.com/hanzoai/next.js.git
synced 2026-10-30 14:46:38 +00:00
40 lines
1.6 KiB
Plaintext
40 lines
1.6 KiB
Plaintext
---
|
|
title: viewTransition
|
|
description: Enable ViewTransition API from React in App Router
|
|
version: experimental
|
|
---
|
|
|
|
`viewTransition` enables React's [View Transitions API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API) integration in Next.js. This lets you animate navigations, loading states, and content changes using the native browser View Transitions API.
|
|
|
|
To enable this feature, you need to set the `viewTransition` property to `true` in your `next.config.js` file.
|
|
|
|
```js filename="next.config.js"
|
|
/** @type {import('next').NextConfig} */
|
|
const nextConfig = {
|
|
experimental: {
|
|
viewTransition: true,
|
|
},
|
|
}
|
|
|
|
module.exports = nextConfig
|
|
```
|
|
|
|
> [!NOTE]
|
|
> The [`<ViewTransition>`](https://react.dev/reference/react/ViewTransition) component is provided by React.
|
|
> The `experimental.viewTransition` flag enables Next.js integration, such as triggering
|
|
> transitions during route navigations.
|
|
|
|
## Usage
|
|
|
|
You can import the [`<ViewTransition>` Component](https://react.dev/reference/react/ViewTransition) from React in your application:
|
|
|
|
```jsx
|
|
import { ViewTransition } from 'react'
|
|
```
|
|
|
|
### Live Demo
|
|
|
|
Check out the [View Transitions Demo](https://react-view-transitions-demo.labs.vercel.dev) to see this feature in action, or read the [designing view transitions guide](/docs/app/guides/view-transitions) for a step-by-step walkthrough.
|
|
|
|
The View Transitions API is a baseline web standard, and browser support continues to expand. As React's [`<ViewTransition>`](https://react.dev/reference/react/ViewTransition) component evolves, more transition patterns and use cases will become available.
|