Animation: cancel-Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.

Das cancel-Ereignis der Animation-Schnittstelle wird ausgelöst, wenn die Methode Animation.cancel() aufgerufen wird oder wenn die Animation von einem anderen Zustand in den "idle"-Abspielzustand wechselt, wie zum Beispiel, wenn die Animation von einem Element entfernt wird, bevor sie vollständig abgespielt wurde.

Hinweis: Das Erstellen einer neuen Animation, die anfänglich im Leerlauf ist, löst kein cancel-Ereignis bei der neuen Animation aus.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("cancel", (event) => { })

oncancel = (event) => { }

Ereignistyp

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.

AnimationPlaybackEvent.currentTime Schreibgeschützt

Die aktuelle Zeit der Animation, die das Ereignis erzeugt hat.

AnimationPlaybackEvent.timelineTime Schreibgeschützt

Der Zeitwert der Zeitleiste der Animation, die das Ereignis erzeugt hat.

Beispiele

Wird diese Animation abgebrochen, entfernen Sie ihr Element.

js
animation.oncancel = (event) => {
  animation.effect.target.remove();
};

Spezifikationen

Specification
Web Animations
# dom-animation-oncancel
Web Animations
# cancel-event

Browser-Kompatibilität

Siehe auch