Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła