Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

KeyframeEffect — efekt animacije ključnim kadrovima

KeyframeEffect opisuje cilj, ključne kadrove i vremenske parametre efekta. Reprodukcijom upravlja zaseban objekt Animation.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)

KeyframeEffect je sučelje Web Animations, a ne dio ECMAScripta. Nasljeđuje od AnimationEffect i opisuje promjene CSS svojstava. Samo stvaranje ne pokreće reprodukciju: dodijelite efekt objektu Animation, čija metoda play() pokreće reprodukciju. Kraći zapis Element.animate() stvara efekt i animaciju te pokreće reprodukciju.

target je element ili null. keyframes prihvaća polje ključnih kadrova ili objekt s vrijednostima svojstava. options je trajanje jedne iteracije u milisekundama ili objekt s postavkama kao što su duration, delay, iterations, easing i fill. Izričite vrijednosti offset moraju biti u rasponu [0, 1] i poredane neopadajuće. new KeyframeEffect(source) kopira definiciju efekta, a ne stanje reprodukcije animacije.

getKeyframes() vraća ključne kadrove s izračunatim pomacima, a setKeyframes() zamjenjuje njihov skup. Naslijeđena metoda updateTiming() mijenja vremenske parametre, dok getComputedTiming() prikazuje izračunati napredak. U primjeru currentTime = 500 postavlja sredinu jedne iteracije od 1000 ms bez pokretanja reprodukcije.

Ovo je API Window; Node 24 u repozitoriju ne potvrđuje dostupnost u pregledniku. Provjerite dostupnost u ciljnom okruženju; primjer provjerava konstruktore, ali ne potvrđuje podršku za svaku opciju.

Primjeri

(() => {
  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();
})();

Rezultat

2
0.5

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori