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

CKTIS / JavaScript

Animation – ovládanie animácií v prehliadači

Animation ovláda prehrávanie efektu na časovej osi. Umožňuje animáciu spustiť, pozastaviť a prechádzať nezávisle od definície jej kľúčových snímok.

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

new Animation(effect, timeline)
const animation = element.animate(keyframes, options);

Animation ovláda prehrávanie; KeyframeEffect opisuje kľúčové snímky a časové parametre, zatiaľ čo DocumentTimeline poskytuje časovú os. Ide o Web API, nie o súčasť ECMAScriptu. Samotná prítomnosť Node.js 24 nepotvrdzuje, že je toto API dostupné.

new Animation(effect, timeline) prehrávanie automaticky nespustí; element.animate() vytvorí animáciu a spustí ju. Prehrávanie ovládajú metódy play(), pause(), reverse() a cancel(). Na časovej osi dokumentu predstavuje currentTime milisekundy a môže mať hodnotu null.

ready signalizuje dokončenie čakajúcej operácie prehrávania alebo pozastavenia; finished signalizuje koniec prehrávania. Ak zavoláte cancel() na nedokončenej animácii, ktorá nie je v stave idle, jej čakajúci prísľub finished sa zamietne s chybou AbortError. Ak tento prísľub používate, ošetrite jeho zamietnutie. Pri novo vytvorenej animácii v stave idle prísľub finished čaká na vybavenie. Ak zavoláte cancel(), kým je animácia v stave idle, prísľub zostane čakať na vybavenie.

Príklad nastaví čas bez spustenia prehrávania: lineárna interpolácia vytvorí nepriehľadnosť 0.5. Overte dostupnosť použitých API v cieľovom prehliadači.

Príklady

const box = document.createElement('div');
box.textContent = 'Animation';
document.body.append(box);

const effect = new KeyframeEffect(
  box,
  [{ opacity: 0 }, { opacity: 1 }],
  { duration: 1000, easing: 'linear', fill: 'both' }
);
const animation = new Animation(effect, document.timeline);
animation.currentTime = 500;

console.log(animation.currentTime);
console.log(getComputedStyle(box).opacity);

animation.cancel();
box.remove();

Výsledok

500
0.5

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje