Animation: playState Eigenschaft
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 schreibgeschützte Animation.playState
Eigenschaft der Web Animations API gibt einen enumerierten Wert zurück, der den Wiedergabestatus einer Animation beschreibt.
Wert
idle
-
Die aktuelle Zeit der Animation ist nicht aufgelöst, und es gibt keine ausstehenden Aufgaben.
running
-
Die Animation läuft.
paused
-
Die Animation wurde angehalten, und die
Animation.currentTime
Eigenschaft wird nicht aktualisiert. finished
-
Die Animation hat eine ihrer Grenzen erreicht, und die
Animation.currentTime
Eigenschaft wird nicht aktualisiert.
Früher definierte Web Animations einen pending
Wert, um anzuzeigen, dass ein asynchroner Vorgang wie das Initiieren der Wiedergabe noch nicht abgeschlossen war. Dies wird nun durch die separate Animation.pending
Eigenschaft angezeigt.
Beispiele
Im Growing/Shrinking Alice Game Beispiel können die Spieler ein Ende erleben, in dem Alice in einen Tränenpool weint. Im Spiel sollten aus Leistungsgründen die Tränen nur animiert werden, wenn sie sichtbar sind. Daher müssen sie sofort pausiert werden, sobald sie animiert sind, wie folgt:
// Setting up the tear animations
tears.forEach((el) => {
el.animate(tearsFalling, {
delay: getRandomMsRange(-1000, 1000), // randomized for each tear
duration: getRandomMsRange(2000, 6000), // randomized for each tear
iterations: Infinity,
easing: "cubic-bezier(0.6, 0.04, 0.98, 0.335)",
});
el.pause();
});
// Play the tears falling when the ending needs to be shown.
tears.forEach((el) => {
el.play();
});
// Reset the crying tears animations and pause them.
tears.forEach((el) => {
el.pause();
el.currentTime = 0;
});
Spezifikationen
Specification |
---|
Web Animations # dom-animation-playstate |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Web Animations API
Animation
für andere Methoden und Eigenschaften, die Sie zur Steuerung von Web-Seiten-Animationen verwenden können.