Animation: Animation() Konstruktor

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.

Der Animation()-Konstruktor der Web Animations API gibt eine neue Instanz eines Animation-Objekts zurück.

Syntax

js
new Animation()
new Animation(effect)
new Animation(effect, timeline)

Parameter

effect Optional

Der Zieleffekt, als ein Objekt basierend auf der AnimationEffect-Schnittstelle, das der Animation zugeordnet wird. Obwohl in Zukunft andere Effekte wie SequenceEffects oder GroupEffects möglich sein könnten, ist der derzeit einzige verfügbare Effekt KeyframeEffect. Dies kann null sein (was der Standardwert ist), um anzuzeigen, dass kein Effekt angewendet werden soll.

timeline Optional

Gibt die timeline an, mit der die Animation verknüpft werden soll, als ein Objekt eines Typs basierend auf der AnimationTimeline-Schnittstelle. Der Standardwert ist Document.timeline, dies kann jedoch auch auf null gesetzt werden.

Beispiele

Im Beispiel „Follow the White Rabbit“ wird der Animation()-Konstruktor verwendet, um eine Animation für die rabbitDownKeyframes unter Verwendung der timeline des Dokuments zu erstellen:

js
const rabbitDownAnimation = new Animation(
  rabbitDownKeyframes,
  document.timeline,
);

Spezifikationen

Specification
Web Animations
# dom-animation-animation

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch