CKTIS / JavaScript
Animation.play(): spustenie a obnovenie animácií
Animation.play() spustí existujúcu animáciu alebo obnoví jej prehrávanie. Nevytvára ďalšiu animáciu ani nevracia promise.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
animation.play()animation.play() neprijíma žiadne argumenty a vracia undefined. Pri animácii na časovej osi dokumentu (document.timeline), ako v príklade, play() pri kladnej efektívnej rýchlosti prehrávania zachová aktuálnu pozíciu, ak je aktuálny čas nezáporný a ešte nedosiahol koniec efektu. Ak pri tejto rýchlosti aktuálny čas dosiahol alebo prekročil koniec efektu, play() vráti animáciu na začiatok, aj keď je pozastavená.
Po volaní updatePlaybackRate() sa efektívna rýchlosť prehrávania, ktorú používa play(), môže líšiť od hodnoty playbackRate: ak sa zmena rýchlosti ešte neuplatnila, play() použije novú hodnotu. Na časovej osi dokumentu preto môže zatiaľ neuplatnená záporná hodnota spôsobiť, že play() preskočí z času nula na koniec efektu s konečným trvaním, aj keď playbackRate stále udáva kladnú hodnotu.
Začatie prehrávania môže čakať na asynchrónnu úlohu. animation.ready signalizuje pripravenosť, zatiaľ čo animation.finished signalizuje dokončenie. Samotné volanie play() nečaká ani na jedno z toho.
Ide o Web API, nie o funkciu ECMAScriptu. Overte podporu v cieľovom prehliadači; Node 24 ju nedokazuje. Príklad ukazuje obnovenie prehrávania z pozície v rámci časového rozsahu efektu, nie prípad zatiaľ neuplatnenej zápornej rýchlosti. Používa efekt bez cieľového prvku a nič nevykresľuje.
Príklady
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);Výsledok
true 400 finished 1000
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.