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.

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

Ereignistyp

Ein AnimationPlaybackEvent, das von Event erbt.

Ereigniseigenschaften

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

AnimationPlaybackEvent.currentTime Nur lesbar: Die aktuelle Zeit der Animation, die das Ereignis erzeugt hat.
AnimationPlaybackEvent.timelineTime Nur lesbar: Der Zeitwert der Zeitachse der Animation, die das Ereignis erzeugt hat.

Beispiele

Wenn diese Animation abgebrochen wird, entfernen Sie ihr Element.

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