Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje