CKTIS / JavaScript
Animation.play(): zagon in nadaljevanje animacij
Animation.play() zažene obstoječo animacijo ali nadaljuje njeno predvajanje. Ne ustvari nove animacije in ne vrne obljube.
Različica: 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 sprejme argumentov in vrne undefined. Pri animaciji na časovnici dokumenta (document.timeline), kakršna je v primeru, play() pri pozitivni efektivni hitrosti predvajanja ohrani trenutni položaj, če trenutni čas ni negativen in je pred koncem učinka. Če pri tej hitrosti trenutni čas doseže ali preseže konec učinka, play() vrne animacijo na začetek, tudi če je začasno ustavljena.
Po klicu updatePlaybackRate() se lahko efektivna hitrost predvajanja, ki jo uporablja play(), razlikuje od vrednosti playbackRate: če sprememba hitrosti še ni uveljavljena, play() uporabi novo vrednost. Na časovnici dokumenta lahko zato še neuveljavljena negativna vrednost povzroči, da play() preskoči s časa nič na konec učinka s končnim trajanjem, čeprav playbackRate še vedno kaže pozitivno vrednost.
Začetek predvajanja lahko počaka na asinhrono opravilo. animation.ready označuje pripravljenost, animation.finished pa dokončanje. Sam klic play() ne čaka na nobeno od njiju.
To je spletni API, ne funkcija ECMAScripta. Preverite podporo v ciljnem brskalniku; Node 24 je ne dokazuje. Primer prikazuje nadaljevanje predvajanja s položaja znotraj časovnega razpona učinka, ne pa primera, ko negativna hitrost še ni uveljavljena. Uporablja učinek brez ciljnega elementa in ne izriše ničesar.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.