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 der pagereveal und pageswap-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

// 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

Browser-Kompatibilität

Siehe auch

• Document.startViewTransition()
• Element.activeViewTransition
• pagereveal Ereignis
• pageswap Ereignis
• View Transition API
• ViewTransition