Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła