Document: activeViewTransition property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **activeViewTransition** read-only property of the {{domxref("Document")}} interface returns a {{domxref("ViewTransition")}} instance representing the view transition currently active on the document.
The current {{domxref("ViewTransition")}} can be accessed in other ways:
- The return value of {{domxref("Document.startViewTransition()")}} in the case of same-document view transitions.
- The
viewTransitionproperty of the {{domxref("Window.pagereveal_event", "pagereveal")}} and {{domxref("Window.pageswap_event", "pageswap")}} event 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 a reference to it for later.
Value
A {{domxref("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
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("Document.startViewTransition()")}}
- {{domxref("Element.activeViewTransition")}}
- {{domxref("Window.pagereveal_event", "pagereveal")}} event
- {{domxref("Window.pageswap_event", "pageswap")}} event
- View Transition API
- {{domxref("ViewTransition")}}