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 des Animation-Interfaces wird ausgelöst, wenn die Animation.cancel()-Methode aufgerufen wird oder wenn die Animation von einem anderen Zustand in den "idle"-Spielzustand wechselt, beispielsweise wenn die Animation von einem Element entfernt wird, bevor sie zu Ende gespielt wird.

Hinweis: Das Erstellen einer neuen Animation, die zunächst im Idle-Zustand ist, löst kein cancel-Ereignis für die neue Animation aus.

Syntax

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

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

Ereignistyp

Ereigniseigenschaften

Neben den unten aufgeführten Eigenschaften sind auch die Eigenschaften des übergeordneten Interfaces, Event, verfügbar.

AnimationPlaybackEvent.currentTime Schreibgeschützt

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

AnimationPlaybackEvent.timelineTime Schreibgeschützt

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

Beispiele

Wenn diese Animation abgebrochen wird, 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

BCD tables only load in the browser

Siehe auch