@view-transition
The @view-transition
CSS at-rule is used to opt in the current and destination documents to undergo a view transition, in the case of a cross-document navigation.
For a cross-document view transition to work, the current and destination documents of the navigation also need to be on the same origin.
Syntax
@view-transition {
navigation: auto;
}
Descriptors
-
Specifies the effect this at-rule will have on the document's view transition behavior. Possible values are:
auto
: The document will undergo a view transition when taking part in a navigation, provided the navigation is same-origin, without cross-origin redirects, and itsnavigationType
istraverse
,push
, orreplace
. In the case ofpush
orreplace
, the navigation must be initiated by a user interacting with the page content, not by a browser UI feature.none
: The document will not undergo a view transition.
Formal syntax
@view-transition =
@view-transition { <declaration-list> }
Examples
Transitioning page view
The following code snippets show key concepts used in a page transition demo. The demo uses cross-document view-transitions; a half second transition that occurs when navigating between two pages of a site. For the full demo, see the View transitions multi-page app demo.
The @view-transition
at-rule is specified in the CSS for both your current and destination documents of a navigation to opt them both in to the view transition:
@view-transition {
navigation: auto;
}
In addition to the @view-transition
at-rule, we define two @keyframe
animations and use the animation
shorthand property to apply those keyframe animations to the elements in the outbound (::view-transition-old()
) and inbound (::view-transition-new()
) pages that we want to animate.
/* Create a custom animation */
@keyframes move-out {
from {
transform: translateY(0%);
}
to {
transform: translateY(-100%);
}
}
@keyframes move-in {
from {
transform: translateY(100%);
}
to {
transform: translateY(0%);
}
}
/* Apply the custom animation to the old and new page states */
::view-transition-old(root) {
animation: 0.4s ease-in both move-out;
}
::view-transition-new(root) {
animation: 0.4s ease-in both move-in;
}
Specifications
Specification |
---|
CSS View Transitions Module Level 2 # view-transition-rule |
Browser compatibility
BCD tables only load in the browser