Animation: cancel-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.
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.
addEventListener("cancel", (event) => { })
oncancel = (event) => { }
Ereignistyp
Ein AnimationPlaybackEvent. Erbt von Event.
Ereigniseigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.
AnimationPlaybackEvent.currentTimeSchreibgeschützt-
Die aktuelle Zeit der Animation, die das Ereignis erzeugt hat.
AnimationPlaybackEvent.timelineTimeSchreibgeschützt-
Der Zeitwert der Zeitleiste der Animation, die das Ereignis erzeugt hat.
Beispiele
Wird diese Animation abgebrochen, entfernen Sie ihr Element.
animation.oncancel = (event) => {
animation.effect.target.remove();
};
Spezifikationen
| Spezifikation |
|---|
| Web Animations # dom-animation-oncancel |
| Web Animations # cancel-event |