CKTIS / JavaScript
Animation – ovládání animací v prohlížeči
Animation ovládá přehrávání efektu na časové ose. Umožňuje animaci spustit, pozastavit a procházet nezávisle na definici jejích klíčových snímků.
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
new Animation(effect, timeline)
const animation = element.animate(keyframes, options);Animation ovládá přehrávání; KeyframeEffect popisuje klíčové snímky a časové parametry, zatímco DocumentTimeline poskytuje časovou osu. Jde o Web API, nikoli o součást ECMAScriptu. Samotná přítomnost Node.js 24 nepotvrzuje, že je toto API dostupné.
new Animation(effect, timeline) přehrávání automaticky nespustí; element.animate() vytvoří animaci a spustí ji. Přehrávání ovládají metody play(), pause(), reverse() a cancel(). Na časové ose dokumentu představuje currentTime milisekundy a může mít hodnotu null.
ready signalizuje dokončení čekající operace přehrávání nebo pozastavení; finished signalizuje konec přehrávání. Pokud zavoláte cancel() u nedokončené animace, která není ve stavu idle, její čekající příslib finished se zamítne s chybou AbortError. Pokud tento příslib používáte, ošetřete jeho zamítnutí. U nově vytvořené animace ve stavu idle příslib finished čeká na vyřízení a v tomto stavu zůstane, pokud zavoláte cancel(), zatímco je animace ve stavu idle.
Příklad nastaví čas, aniž by spustil přehrávání: lineární interpolace vytvoří neprůhlednost 0.5. Ověřte dostupnost použitých API v cílovém prohlížeči.
Pří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ýsledek
500 0.5
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.