Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

KeyframeEffect — efekt animácie kľúčových snímok

KeyframeEffect opisuje cieľ efektu, kľúčové snímky a časovacie parametre. Prehrávanie riadi samostatný objekt Animation.

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

KeyframeEffect je rozhranie Web Animations, nie súčasť ECMAScriptu. Dedí z AnimationEffect a opisuje zmeny vlastností CSS. Samotné vytvorenie prehrávanie nespustí: priraďte efekt objektu Animation, ktorého metóda play() prehrávanie spustí. Skrátený zápis Element.animate() vytvorí efekt aj animáciu a spustí prehrávanie.

target je element alebo null. keyframes prijíma pole kľúčových snímok alebo objekt s hodnotami vlastností. options je trvanie jednej iterácie v milisekundách alebo objekt s nastaveniami, ako sú duration, delay, iterations, easing a fill. Explicitné hodnoty offset musia patriť do [0, 1] a byť zoradené neklesajúcim spôsobom. new KeyframeEffect(source) kopíruje definíciu efektu, nie stav prehrávania animácie.

getKeyframes() vracia kľúčové snímky s vypočítanými posunmi a setKeyframes() ich množinu nahrádza. Zdedená metóda updateTiming() mení časovacie parametre, zatiaľ čo getComputedTiming() sprístupňuje vypočítaný priebeh. V príklade currentTime = 500 nastaví stred jednej iterácie trvajúcej 1000 ms bez spustenia prehrávania.

Ide o API Window; Node 24 v repozitári nedokladá jeho dostupnosť v prehliadači. Overte dostupnosť v cieľovom prostredí; príklad kontroluje konštruktory, ale nedokladá podporu každej možnosti.

Prí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ýsledok

2
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.

Zdroje