Dokument: activeViewTransition-Eigenschaft
Die schreibgeschützte activeViewTransition-Eigenschaft der Document-Schnittstelle gibt eine ViewTransition-Instanz zurück, die die aktuell aktive Ansichtsübergang des Dokuments darstellt.
Der aktuelle ViewTransition kann auf andere Weise abgerufen werden:
- Der Rückgabewert von
Document.startViewTransition()im Fall von gleichseitigen Ansichtsübergängen. - Die
viewTransition-Eigenschaft derpagereveal- undpageswap-Ereignisobjekte im Fall von übergreifenden Dokumentenübergängen.
Jedoch bietet die activeViewTransition-Eigenschaft eine konsistente Möglichkeit, auf den aktiven Ansichtsübergang in jedem Kontext zuzugreifen, ohne sich Sorgen machen zu müssen, diesen für einen späteren einfachen Zugriff zu speichern.
Wert
Ein 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
| Specification |
|---|
| CSS View Transitions Module Level 2 # dom-document-activeviewtransition |
Browser-Kompatibilität
Siehe auch
Document.startViewTransition()pagereveal-Ereignispageswap-Ereignis- View Transition API
ViewTransition