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

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.

Zdroje