You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: reword the docs of veiw transition flag (#76841)
### What
Mention it's experimental feature and maintained by react team, we're
still developing it
---------
Co-authored-by: JJ Kasper <[email protected]>
Copy file name to clipboardExpand all lines: docs/01-app/04-api-reference/05-config/01-next-config-js/viewTransition.mdx
+5-4Lines changed: 5 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Enable ViewTransition API from React in App Router
4
4
version: experimental
5
5
---
6
6
7
-
`viewTransition` is an experimental feature that a feature flag to enable the new experimental [View Transitions API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API)with React. This new API allows you to leverage the View Transition browser API to create seamless transitions.
7
+
`viewTransition` is an experimental flag that enables the new experimental [View Transitions API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API)in React. This API allows you to leverage the native View Transitions browser API to create seamless transitions between UI states.
8
8
9
9
To enable this feature, you need to set the `viewTransition` property to `true` in your `next.config.js` file.
10
10
@@ -19,7 +19,8 @@ const nextConfig = {
19
19
module.exports= nextConfig
20
20
```
21
21
22
-
> Note: This feature is highly experimental and may change in future releases.
22
+
> Important Notice: This feature is not developed or maintained by the Next.js team — it is an experimental API from the React team. It is still in **early stages** and **not recommended for production use**. The implementation is still being iterated on, and its behavior may change in future React releases.
23
+
> Enabling this feature requires understanding the experimental nature of the API. To fully grasp its behavior, refer to the [React pull request](https://github.com/facebook/react/pull/31975) and related discussions.
23
24
24
25
## Usage
25
26
@@ -29,10 +30,10 @@ Once enabled, you can import the `ViewTransition` component from React in your a
For more details on how to use this feature, refer to the [original View Transitions pull request](https://github.com/facebook/react/pull/31975) in the React repository. This feature builds upon the native browser implementation of View Transitions.
33
+
However, documentation and examples are currently limited, and you will need to refer directly to React’s source code and discussions to understand how this works.
33
34
34
35
### Live Demo
35
36
36
37
Check out our [Next.js View Transition Demo](https://view-transition-example.vercel.app) to see this feature in action.
37
38
38
-
We will continue to expand our documentation and examples as this API evolves.
39
+
As this API evolves, we will update our documentation and share more examples. However, for now, we strongly advise against using this feature in production.
0 commit comments