Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri