Dokument: activeViewTransition-Eigenschaft
Die schreibgeschützte activeViewTransition-Eigenschaft der Document-Schnittstelle gibt eine ViewTransition-Instanz zurück, die die derzeit auf dem Dokument aktive View-Übergang darstellt.
Der aktuelle ViewTransition kann auf andere Weise abgerufen werden:
- Der Rückgabewert von
Document.startViewTransition()im Falle von View-Übergängen innerhalb desselben Dokuments. - Die
viewTransition-Eigenschaft derpagereveal- undpageswap-Ereignisobjekte im Falle von View-Übergängen über Dokumentgrenzen hinweg.
Jedoch bietet die activeViewTransition-Eigenschaft eine konsistente Möglichkeit, auf den aktiven View-Übergang in jedem Kontext zuzugreifen, ohne sich später um das Speichern für einen einfachen Zugriff kümmern zu müssen.
Wert
Eine ViewTransition oder null, wenn kein aktiver View-Ü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
| Specification |
|---|
| CSS View Transitions Module Level 2> # dom-document-activeviewtransition> |
Browser-Kompatibilität
Loading…
Siehe auch
Document.startViewTransition()pagereveal-Ereignispageswap-Ereignis- View Transition API
ViewTransition