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.