Document: activeViewTransition property
The activeViewTransition read-only property of the Document interface returns a ViewTransition instance representing the view transition currently active on the document.
The current ViewTransition can be accessed in other ways:
- The return value of
Document.startViewTransition()in the case of same-document view transitions. - The
viewTransitionproperty of thepagerevealandpageswapevent objects in the case of cross-document view transitions.
However, the activeViewTransition property provides a consistent way to access the active view transition in any context, without having to worry about saving it for easy access later on.
Value
A ViewTransition or null if there is no active view transition.
Examples
js
// Start a view transition
document.startViewTransition(() => {
// Update the UI to reflect the new state
updateUI();
});
// Check if a view transition is currently active
if (document.activeViewTransition) {
console.log("A view transition is currently active");
}
// Respond to view transition finishing
document.activeViewTransition.finished.then(() => {
console.log("View transition finished");
});
Specifications
| Specification |
|---|
| CSS View Transitions Module Level 2 # dom-document-activeviewtransition |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
activeViewTransition
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support