Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

Siehe auch