Element: getAnimations() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2020.
Die getAnimations()-Methode der Element-Schnittstelle (spezifiziert im Animatable-Mixin) gibt ein Array aller Animation-Objekte zurück, die dieses Element beeinflussen oder geplant sind, dies zukünftig zu tun. Optional können auch Animation-Objekte für Nachkommen-Elemente zurückgegeben werden.
Hinweis: Dieses Array umfasst CSS-Animationen, CSS-Übergänge und Web-Animationen.
Syntax
getAnimations()
getAnimations(options)
Parameter
optionsOptional-
Ein Optionsobjekt, das die folgende Eigenschaft enthält:
subtree-
Ein boolescher Wert, der, wenn
true, verursacht, dass auch Animationen zurückgegeben werden, die Nachkommen des Element anvisieren. Dies schließt Animationen ein, die auf CSS-Pseudoelemente abzielen, die an das Element oder eines seiner Nachkommen angehängt sind. Standardwert istfalse.
Rückgabewert
Ein Array von Animation-Objekten, von denen jedes eine Animation repräsentiert, die aktuell auf das Element, auf dem diese Methode aufgerufen wurde, abzielt, oder auf eines seiner Nachkommelemente, wenn { subtree: true } spezifiziert ist.
Beispiele
Der folgende Code-Schnipsel wartet darauf, dass alle Animationen auf elem und seinen Nachkommen beendet sind, bevor das Element aus dem Dokument entfernt wird.
Promise.all(
elem.getAnimations({ subtree: true }).map((animation) => animation.finished),
).then(() => elem.remove());
Spezifikationen
| Specification |
|---|
| Web Animations # dom-animatable-getanimations |
Browser-Kompatibilität
Loading…
Siehe auch
- Web-Animations-API
- CSS-Animationen
- CSS-Übergänge
Document.getAnimations()- Holt alle Animationen im DokumentAnimation