CKTIS / JavaScript
KeyframeEffect — efekt animace klíčových snímků
KeyframeEffect popisuje cíl efektu, klíčové snímky a časovací parametry. Přehrávání řídí samostatný objekt Animation.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)KeyframeEffect je rozhraní Web Animations, nikoli součást ECMAScriptu. Dědí z AnimationEffect a popisuje změny vlastností CSS. Samotné vytvoření přehrávání nespustí: přiřaďte efekt objektu Animation, jehož metoda play() přehrávání zahájí. Zkrácený zápis Element.animate() vytvoří efekt i animaci a spustí přehrávání.
target je element nebo null. keyframes přijímá pole klíčových snímků nebo objekt s hodnotami vlastností. options je doba jedné iterace v milisekundách nebo objekt s nastaveními, jako jsou duration, delay, iterations, easing a fill. Explicitní hodnoty offset musí ležet v [0, 1] a být seřazeny neklesajícím způsobem. new KeyframeEffect(source) kopíruje definici efektu, nikoli stav přehrávání animace.
getKeyframes() vrací klíčové snímky s vypočtenými posuny a setKeyframes() jejich sadu nahrazuje. Zděděná metoda updateTiming() mění časovací parametry, zatímco getComputedTiming() zpřístupňuje vypočtený průběh. V příkladu currentTime = 500 nastaví střed jediné iterace dlouhé 1000 ms, aniž by se spustilo přehrávání.
Jde o API Window; Node 24 v repozitáři nedokládá jeho dostupnost v prohlížeči. Ověřte dostupnost v cílovém prostředí; příklad kontroluje konstruktory, ale nedokládá podporu všech možností.
Pří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ýsledek
2 0.5
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.