Back to Next Js

viewTransition

docs/01-app/03-api-reference/05-config/01-next-config-js/viewTransition.mdx

16.2.51.5 KB
Original Source

viewTransition enables React's View Transitions 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
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    viewTransition: true,
  },
}

module.exports = nextConfig

[!NOTE] The <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 from React in your application:

jsx
import { ViewTransition } from 'react'

Live Demo

Check out the View Transitions Demo to see this feature in action, or read the designing view transitions guide 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> component evolves, more transition patterns and use cases will become available.