CKTIS / JavaScript
Animation — sterowanie animacją w przeglądarce
Animation steruje odtwarzaniem efektu na osi czasu. Pozwala uruchamiać, zatrzymywać i przewijać animację niezależnie od definicji jej klatek kluczowych.
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 Animation(effect, timeline)
const animation = element.animate(keyframes, options);Animation steruje odtwarzaniem; KeyframeEffect opisuje klatki kluczowe i parametry czasowe, a DocumentTimeline dostarcza oś czasu. To Web API, nie część ECMAScript. Sama obecność Node.js 24 nie potwierdza jego dostępności.
new Animation(effect, timeline) nie uruchamia odtwarzania automatycznie; element.animate() tworzy animację i ją uruchamia. Metody play(), pause(), reverse() i cancel() sterują odtwarzaniem. Dla osi czasu dokumentu currentTime oznacza milisekundy i może mieć wartość null.
ready sygnalizuje zakończenie oczekującej operacji odtwarzania lub pauzy; finished — zakończenie odtwarzania. Wywołanie cancel() na niedokończonej animacji, która nie jest w stanie idle, odrzuca oczekującą obietnicę finished z błędem AbortError. Jeśli korzystasz z tej obietnicy, obsłuż jej odrzucenie. Nowo utworzona animacja w stanie idle ma oczekującą obietnicę finished, która pozostaje w stanie oczekiwania po wywołaniu cancel(), gdy animacja jest w stanie idle.
Przykład ustawia czas bez uruchamiania animacji: liniowa interpolacja daje przezroczystość 0.5. Sprawdź dostępność używanych API w docelowej przeglądarce.
Przykłady
const box = document.createElement('div');
box.textContent = 'Animation';
document.body.append(box);
const effect = new KeyframeEffect(
box,
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, easing: 'linear', fill: 'both' }
);
const animation = new Animation(effect, document.timeline);
animation.currentTime = 500;
console.log(animation.currentTime);
console.log(getComputedStyle(box).opacity);
animation.cancel();
box.remove();Wynik
500 0.5
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.