CKTIS / JavaScript
KeyframeEffect — efekt animacji klatek kluczowych
KeyframeEffect opisuje cel, klatki kluczowe i parametry czasowe efektu. Odtwarzaniem steruje osobny obiekt Animation.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)KeyframeEffect to interfejs Web Animations, a nie element ECMAScript. Dziedziczy po AnimationEffect i opisuje zmiany właściwości CSS. Sam konstruktor nie uruchamia odtwarzania: efekt należy przypisać do Animation, którego metoda play() rozpoczyna odtwarzanie. Skrót Element.animate() tworzy efekt oraz animację i uruchamia odtwarzanie.
target to element lub null. keyframes przyjmuje tablicę klatek albo obiekt z wartościami właściwości. options jest czasem jednej iteracji w milisekundach lub obiektem zawierającym np. duration, delay, iterations, easing i fill. Jawne wartości offset muszą należeć do przedziału [0, 1] i być uporządkowane niemalejąco. new KeyframeEffect(source) kopiuje definicję efektu, nie stan odtwarzania animacji.
getKeyframes() zwraca klatki z obliczonymi przesunięciami, a setKeyframes() zastępuje ich zestaw. Odziedziczone updateTiming() zmienia parametry czasowe, natomiast getComputedTiming() udostępnia obliczony postęp. W przykładzie currentTime = 500 ustala połowę pojedynczej iteracji trwającej 1000 ms bez odtwarzania.
To API środowiska Window; Node 24 w repozytorium nie potwierdza jego dostępności w przeglądarce. Sprawdzaj dostępność w środowisku docelowym; przykład sprawdza konstruktory, ale nie dowodzi obsługi wszystkich opcji.
Przykłady
(() => {
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();
})();Wynik
2 0.5
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.