CKTIS / JavaScript
KeyframeEffect — ефект на анимация с ключови кадри
KeyframeEffect описва целта, ключовите кадри и параметрите за време на ефекта. Възпроизвеждането се управлява от отделен обект Animation.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)KeyframeEffect е интерфейс на Web Animations, а не част от ECMAScript. Той наследява от AnimationEffect и описва промени в CSS свойствата. Самото създаване не започва възпроизвеждане: задайте ефекта на обект Animation, чийто метод play() започва възпроизвеждането. Съкратеният вариант Element.animate() създава ефекта и анимацията и започва възпроизвеждането.
target е елемент или null. keyframes приема масив от ключови кадри или обект със стойности на свойства. options е продължителността на една итерация в милисекунди или обект с настройки като duration, delay, iterations, easing и fill. Изричните стойности на offset трябва да са в [0, 1] и подредени в ненамаляващ ред. new KeyframeEffect(source) копира дефиницията на ефекта, а не състоянието на възпроизвеждане на анимацията.
getKeyframes() връща ключови кадри с изчислени отмествания, а setKeyframes() заменя набора им. Наследеният метод updateTiming() променя параметрите за време, а getComputedTiming() предоставя изчисления напредък. В примера currentTime = 500 задава средата на една итерация с продължителност 1000 ms, без да започва възпроизвеждане.
Това е API на Window; Node 24 в хранилището не доказва наличността му в браузър. Проверете наличността в целевата среда; примерът проверява конструкторите, но не доказва поддръжка на всяка опция.
Примери
(() => {
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();
})();Резултат
2 0.5
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.