Dokument: activeViewTransition-Eigenschaft
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die schreibgeschützte Eigenschaft activeViewTransition der Document-Schnittstelle gibt eine ViewTransition-Instanz zurück, die die derzeit auf dem Dokument aktive Ansichtsübergang repräsentiert.
Der aktuelle ViewTransition kann auf andere Weise zugänglich gemacht werden:
- Der Rückgabewert von
Document.startViewTransition()im Fall von gleichseitigen Ansichtsübergängen. - Die
viewTransition-Eigenschaft derpagereveal- undpageswap-Ereignisobjekte im Fall von dokumentübergreifenden Ansichtsübergängen.
Jedoch bietet die activeViewTransition-Eigenschaft eine konsistente Möglichkeit, auf den aktiven Ansichtsübergang in jedem Kontext zuzugreifen, ohne sich später Gedanken darüber machen zu müssen, wie man ihn leicht zugänglich speichert.
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
| Specification |
|---|
| CSS View Transitions Module Level 2 # dom-document-activeviewtransition |
Browser-Kompatibilität
Siehe auch
Document.startViewTransition()pagereveal-Ereignispageswap-Ereignis- View Transition API
ViewTransition