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

CKTIS / JavaScript

KeyframeEffect — efekt animace klíčových snímků

KeyframeEffect popisuje cíl efektu, klíčové snímky a časovací parametry. Přehrávání řídí samostatný objekt Animation.

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 KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)

KeyframeEffect je rozhraní Web Animations, nikoli součást ECMAScriptu. Dědí z AnimationEffect a popisuje změny vlastností CSS. Samotné vytvoření přehrávání nespustí: přiřaďte efekt objektu Animation, jehož metoda play() přehrávání zahájí. Zkrácený zápis Element.animate() vytvoří efekt i animaci a spustí přehrávání.

target je element nebo null. keyframes přijímá pole klíčových snímků nebo objekt s hodnotami vlastností. options je doba jedné iterace v milisekundách nebo objekt s nastaveními, jako jsou duration, delay, iterations, easing a fill. Explicitní hodnoty offset musí ležet v [0, 1] a být seřazeny neklesajícím způsobem. new KeyframeEffect(source) kopíruje definici efektu, nikoli stav přehrávání animace.

getKeyframes() vrací klíčové snímky s vypočtenými posuny a setKeyframes() jejich sadu nahrazuje. Zděděná metoda updateTiming() mění časovací parametry, zatímco getComputedTiming() zpřístupňuje vypočtený průběh. V příkladu currentTime = 500 nastaví střed jediné iterace dlouhé 1000 ms, aniž by se spustilo přehrávání.

Jde o API Window; Node 24 v repozitáři nedokládá jeho dostupnost v prohlížeči. Ověřte dostupnost v cílovém prostředí; příklad kontroluje konstruktory, ale nedokládá podporu všech možností.

Příklady

(() => {
  if (typeof KeyframeEffect !== "function" || typeof Animation !== "function") {
    throw new Error("Web Animations API required");
  }
  const target = document.createElement("div");
  const effect = new KeyframeEffect(
    target,
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, easing: "linear" }
  );
  const animation = new Animation(effect, document.timeline);
  animation.currentTime = 500;
  console.log(effect.getKeyframes().length);
  console.log(effect.getComputedTiming().progress);
  animation.cancel();
})();

Výsledek

2
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