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 March 2020.

Die getAnimations()-Methode der Element-Schnittstelle (spezifiziert im Animatable-Mixin) gibt ein Array aller Animation-Objekte zurück, die dieses Element beeinflussen oder in Zukunft beeinflussen sollen. Sie kann optional auch Animation-Objekte für nachfolgende Elemente zurückgeben.

Hinweis: Dieses Array enthält 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, bewirkt, dass auch Animationen zurückgegeben werden, die Nachfolger des Element anvisieren. Dies schließt Animationen ein, die auf CSS-Pseudoelemente abzielen, die am Element oder einem seiner Nachfolger angehängt sind. Standardwert ist false.

Rückgabewert

Ein Array von Animation-Objekten, die jeweils eine Animation darstellen, die derzeit das Element anvisiert, auf dem diese Methode aufgerufen wird, oder eines seiner nachfolgenden Elemente, wenn { subtree: true } angegeben ist.

Beispiele

Das folgende Codebeispiel wartet darauf, dass alle Animationen auf elem und seinen Nachfolgern abgeschlossen 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

BCD tables only load in the browser

Siehe auch