Dokument: activeViewTransition Eigenschaft
Die schreibgeschützte Eigenschaft activeViewTransition der Document-Schnittstelle gibt eine ViewTransition-Instanz zurück, die die derzeit aktive Ansichtsübergang auf dem Dokument darstellt.
Die aktuelle ViewTransition kann auf andere Weise abgerufen werden:
- Der Rückgabewert von
Document.startViewTransition()im Falle von Ansichtsübergängen im selben Dokument. - Die
viewTransition-Eigenschaft derpagerevealundpageswap-Ereignisobjekte im Falle von dokumentübergreifenden Ansichtsübergängen.
Jedoch bietet die Eigenschaft activeViewTransition eine konsistente Möglichkeit, um auf den aktiven Ansichtsübergang in jedem Kontext zuzugreifen, ohne sich darum kümmern zu müssen, eine Referenz dafür später zu speichern.
Wert
Eine ViewTransition oder null, wenn kein aktiver Ansichtsübergang vorhanden ist.
Beispiele
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");
});
Spezifikationen
| Spezifikation |
|---|
| CSS View Transitions Module Level 2 # dom-document-activeviewtransition |