WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Animation.play(): Animationen starten und fortsetzen

Animation.play() startet eine vorhandene Animation oder setzt sie fort. Die Methode erstellt weder eine weitere Animation noch gibt sie ein Promise zurück.

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

animation.play()

animation.play() nimmt keine Argumente entgegen und gibt undefined zurück. Bei einer Animation auf der Zeitachse des Dokuments (document.timeline) wie im Beispiel behält play() bei positiver effektiver Wiedergabegeschwindigkeit die aktuelle Position bei, wenn die aktuelle Zeit nicht negativ ist und vor dem Ende des Effekts liegt. Liegt sie bei dieser Geschwindigkeit am oder nach dem Ende des Effekts, setzt play() die Animation an den Anfang zurück, auch wenn sie pausiert ist.

Nach einem Aufruf von updatePlaybackRate() kann die von play() verwendete effektive Wiedergabegeschwindigkeit von playbackRate abweichen: Steht eine Änderung der Geschwindigkeit noch aus, verwendet play() den ausstehenden Wert. Auf der Zeitachse des Dokuments kann ein ausstehender negativer Wert deshalb dazu führen, dass play() vom Zeitpunkt null zum Ende eines Effekts mit endlicher Dauer springt, obwohl playbackRate noch einen positiven Wert liefert.

Der Start der Wiedergabe kann auf eine asynchrone Aufgabe warten. animation.ready signalisiert die Bereitschaft, animation.finished dagegen den Abschluss. Der Aufruf von play() selbst wartet auf keines von beiden.

Dies ist eine Web API, kein ECMAScript-Feature. Prüfe die Unterstützung im Zielbrowser; Node 24 belegt sie nicht. Das Beispiel zeigt das Fortsetzen ab einer Position innerhalb des Effektzeitraums, nicht den Fall einer ausstehenden negativen Wiedergabegeschwindigkeit. Es verwendet einen Effekt ohne Zielelement und zeichnet nichts.

Beispiele

const effect = new KeyframeEffect(null, [], { duration: 1000 });
const animation = new Animation(effect, document.timeline);

animation.currentTime = 400;
const result = animation.play();
console.log(result === undefined, animation.currentTime);

animation.finish();
console.log(animation.playState, animation.currentTime);

Ergebnis

true 400
finished 1000

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.

Quellen