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.