CKTIS / JavaScript
KeyframeEffect — učinek animacije s ključnimi sličicami
KeyframeEffect opisuje cilj učinka, ključne sličice in časovne parametre. Predvajanje upravlja ločen objekt Animation.
Različica: 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 vmesnik Web Animations, ne del ECMAScripta. Deduje od AnimationEffect in opisuje spremembe lastnosti CSS. Sama izdelava ne začne predvajanja: učinek dodelite objektu Animation, katerega metoda play() začne predvajanje. Krajši zapis Element.animate() ustvari učinek in animacijo ter začne predvajanje.
target je element ali null. keyframes sprejme polje ključnih sličic ali objekt z vrednostmi lastnosti. options je trajanje ene ponovitve v milisekundah ali objekt z nastavitvami, kot so duration, delay, iterations, easing in fill. Izrecne vrednosti offset morajo biti v območju [0, 1] in razvrščene naraščajoče ali enako. new KeyframeEffect(source) kopira definicijo učinka, ne stanja predvajanja animacije.
getKeyframes() vrne ključne sličice z izračunanimi odmiki, setKeyframes() pa zamenja njihov nabor. Podedovana metoda updateTiming() spremeni časovne parametre, medtem ko getComputedTiming() razkrije izračunani napredek. V primeru currentTime = 500 nastavi sredino ene ponovitve, dolge 1000 ms, ne da bi začel predvajanje.
To je API Window; Node 24 v repozitoriju ne potrjuje njegove razpoložljivosti v brskalniku. Razpoložljivost preverite v ciljnem okolju; primer preveri konstruktorje, ne potrjuje pa podpore za vsako možnost.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.