CKTIS / JavaScript
Animation – Animationen im Browser steuern
Animation steuert die Wiedergabe eines Effekts auf einer Zeitleiste. Damit lassen sich Animationen unabhängig von ihrer Keyframe-Definition starten, pausieren und gezielt durchlaufen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Animation(effect, timeline)
const animation = element.animate(keyframes, options);Animation steuert die Wiedergabe; KeyframeEffect beschreibt Keyframes und Zeitparameter, während DocumentTimeline die Zeitleiste bereitstellt. Dies ist eine Web-API und kein Bestandteil von ECMAScript. Allein die Verfügbarkeit von Node.js 24 belegt nicht, dass diese API verfügbar ist.
new Animation(effect, timeline) startet die Wiedergabe nicht automatisch; element.animate() erstellt eine Animation und startet sie. Die Methoden play(), pause(), reverse() und cancel() steuern die Wiedergabe. Auf einer Dokument-Zeitleiste gibt currentTime die Zeit in Millisekunden an und kann null sein.
ready signalisiert den Abschluss eines ausstehenden Wiedergabe- oder Pausenvorgangs; finished signalisiert das Ende der Wiedergabe. Rufst du cancel() für eine noch nicht abgeschlossene Animation auf, die nicht im Zustand idle ist, wird ihr ausstehendes Promise finished mit AbortError zurückgewiesen. Behandle die Zurückweisung, wenn du dieses Promise verwendest. Bei einer neu erstellten Animation im Zustand idle ist das Promise finished ausstehend. Es bleibt ausstehend, wenn du cancel() aufrufst, während die Animation im Zustand idle ist.
Das Beispiel setzt die Zeit, ohne die Wiedergabe zu starten: Die lineare Interpolation ergibt eine Deckkraft von 0.5. Prüfe, ob die verwendeten APIs in deinem Zielbrowser verfügbar sind.
Beispiele
const box = document.createElement('div');
box.textContent = 'Animation';
document.body.append(box);
const effect = new KeyframeEffect(
box,
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, easing: 'linear', fill: 'both' }
);
const animation = new Animation(effect, document.timeline);
animation.currentTime = 500;
console.log(animation.currentTime);
console.log(getComputedStyle(box).opacity);
animation.cancel();
box.remove();Ergebnis
500 0.5
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.