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