CKTIS / JavaScript
Animation.play(): pokretanje i nastavljanje animacija
Animation.play() pokreće postojeću animaciju ili nastavlja njezinu reprodukciju. Ne stvara drugu animaciju niti vraća obećanje.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
animation.play()animation.play() ne prima argumente i vraća undefined. Za animaciju na vremenskoj crti dokumenta (document.timeline), kao u primjeru, play() pri pozitivnoj efektivnoj brzini reprodukcije zadržava trenutačni položaj ako trenutačno vrijeme nije negativno i još nije dosegnulo kraj efekta. Ako pri toj brzini trenutačno vrijeme dosegne ili prijeđe kraj efekta, play() vraća animaciju na početak, čak i ako je pauzirana.
Nakon poziva updatePlaybackRate() efektivna brzina reprodukcije koju upotrebljava play() može se razlikovati od vrijednosti playbackRate: ako promjena brzine još nije primijenjena, play() upotrebljava novu vrijednost. Na vremenskoj crti dokumenta takva još neprimijenjena negativna vrijednost može uzrokovati da play() preskoči s nultog vremena na kraj efekta konačnog trajanja iako playbackRate još uvijek pokazuje pozitivnu vrijednost.
Pokretanje reprodukcije može čekati na asinkroni zadatak. animation.ready označava spremnost, a animation.finished dovršetak. Sam poziv play() ne čeka ni jedno ni drugo.
Ovo je web API, a ne značajka ECMAScripta. Provjerite podršku u ciljnom pregledniku; Node 24 to ne potvrđuje. Primjer prikazuje nastavak reprodukcije s položaja unutar vremenskog raspona efekta, a ne slučaj u kojem negativna brzina još nije primijenjena. Koristi efekt bez ciljnog elementa i ne iscrtava ništa.
Primjeri
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);Rezultat
true 400 finished 1000
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.