CKTIS / JavaScript
Animation.play(): uruchamianie i wznawianie animacji
Metoda Animation.play() uruchamia lub wznawia istniejącą animację. Nie tworzy nowej animacji ani nie zwraca obietnicy.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
animation.play()animation.play() nie przyjmuje argumentów i zwraca undefined. W przypadku animacji korzystającej z osi czasu dokumentu (document.timeline), jak w przykładzie, przy dodatniej efektywnej szybkości odtwarzania metoda zachowuje bieżącą pozycję, jeśli bieżący czas animacji jest nieujemny i nie osiągnął jeszcze końca efektu. Jeśli przy tej szybkości bieżący czas jest równy czasowi końca efektu lub go przekracza, play() cofa animację do początku, nawet gdy jest ona wstrzymana.
Po wywołaniu updatePlaybackRate() efektywna szybkość odtwarzania używana przez play() może różnić się od wartości playbackRate: jeśli zmiana szybkości nie została jeszcze zastosowana, play() uwzględnia oczekującą wartość. Na osi czasu dokumentu oczekująca ujemna wartość może więc sprawić, że play() przestawi bieżący czas animacji z zera na koniec efektu o skończonym czasie trwania, mimo że playbackRate nadal ma wartość dodatnią.
Rozpoczęcie odtwarzania może oczekiwać na zadanie asynchroniczne. animation.ready sygnalizuje gotowość, a animation.finished — zakończenie. Samo play() nie czeka na żadne z nich.
To Web API, nie funkcja ECMAScript. Sprawdź obsługę w docelowej przeglądarce; Node 24 jej nie dowodzi. Przykład pokazuje wznowienie od pozycji mieszczącej się w zakresie efektu, a nie przypadek oczekującej ujemnej szybkości. Używa efektu bez elementu docelowego i niczego nie rysuje.
Przykłady
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);Wynik
true 400 finished 1000
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.