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
(festgelegt im Animatable Mixin) gibt ein Array aller
Animation-Objekte zurück, die dieses Element betreffen oder in Zukunft betreffen sollen. Sie kann optional auch Animation-Objekte für nachfolgende
Elemente zurückgeben.
Hinweis: Dieses Array umfasst CSS-Animationen, CSS-Übergänge und Web-Animationen.
Syntax
getAnimations()
getAnimations(options)
Parameter
optionsOptional-
Ein Optionsobjekt, das folgende Eigenschaft enthält:
subtree-
Ein boolescher Wert, der, wenn
true, bewirkt, dass auch Animationen zurückgegeben werden, die auf Nachkommen von Element abzielen. Dies schließt Animationen ein, die auf CSS-Pseudoelemente abzielen, die an Element oder einen seiner Nachkommen angehängt sind. Standardmäßigfalse.
Rückgabewert
Ein Array von Animation-Objekten, von denen jedes eine
Animation darstellt, die derzeit auf das Element abzielt, auf dem diese Methode aufgerufen wird, oder auf eines seiner Nachkommelemente, falls { subtree: true } angegeben ist.
Beispiele
Der folgende Codeausschnitt wartet auf alle Animationen auf elem und seinen
Nachkommen, 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
Siehe auch
- Web Animations API
- CSS-Animationen
- CSS-Übergänge
Document.getAnimations()- Abruf aller Animationen im DokumentAnimation