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 July 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

js
getAnimations()
getAnimations(options)

Parameter

options Optional

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 ist false.

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.

js
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