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.