Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Animation.play(): spuštění a obnovení animací

Animation.play() spustí existující animaci nebo obnoví její přehrávání. Nevytváří další animaci ani nevrací promise.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

animation.play()

animation.play() nepřijímá žádné argumenty a vrací undefined. U animace na časové ose dokumentu (document.timeline), jako v příkladu, zachová play() při kladné efektivní rychlosti přehrávání aktuální pozici, pokud je aktuální čas nezáporný a leží před koncem efektu. Pokud při této rychlosti aktuální čas dosáhl konce efektu nebo jej překročil, play() vrátí animaci na začátek, i když je pozastavená.

Po volání updatePlaybackRate() se efektivní rychlost přehrávání, kterou play() používá, může lišit od hodnoty playbackRate: pokud se změna rychlosti ještě neprovedla, play() použije novou hodnotu. Na časové ose dokumentu proto může dosud neuplatněná záporná hodnota způsobit, že play() přeskočí z času nula na konec efektu s konečnou dobou trvání, i když playbackRate stále udává kladnou hodnotu.

Zahájení přehrávání může čekat na asynchronní úlohu. animation.ready signalizuje připravenost, zatímco animation.finished signalizuje dokončení. Samotné volání play() nečeká ani na jedno z toho.

Jde o Web API, nikoli o funkci ECMAScriptu. Ověřte podporu v cílovém prohlížeči; Node 24 ji nedokládá. Příklad ukazuje obnovení přehrávání z pozice uvnitř časového rozsahu efektu, nikoli případ dosud neuplatněné záporné rychlosti. Používá efekt bez cílového prvku a nic nevykresluje.

Pří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ýsledek

true 400
finished 1000

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje