Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WAAPI: tablica klatek kluczowych i opcje czasowe

Przekaż klatki kluczowe do `Element.animate()` jako tablicę, a czas jednej iteracji, przebieg postępu i liczbę iteracji ustaw w osobnym obiekcie opcji.

Wersja: Current web platform; runtime support varies

Składnia

element.animate(keyframes, { duration, easing, iterations })
element.animate(keyframes, duration)

element.animate(keyframes, options) tworzy animację elementu DOM, uruchamia ją i zwraca obiekt Animation. Ta metoda i jej opcje czasowe należą do Web Animations API (WAAPI), a nie do ECMAScript 2024 ani żadnego innego wydania ECMAScript. Ich dostępność zależy od środowiska uruchomieniowego.

W tablicy klatek kluczowych każdy obiekt określa wartości animowalnych właściwości CSS, np. opacity, w jednym punkcie iteracji. offset wskazuje ten punkt w zakresie od 0 do 1 włącznie. Podane wartości offset muszą być w kolejności niemalejącej. Brakujące pozycje są rozmieszczane równomiernie; trzy klatki bez offset otrzymują pozycje 0, 0.5 i 1. Inną obsługiwaną postacią jest jeden obiekt z tablicami wartości właściwości, np. { opacity: [0, 1] }.

W opcjach liczbowe duration oznacza czas jednej iteracji w milisekundach. Samą liczbę można też przekazać jako drugi argument — to skrót ustawiający wyłącznie duration. iterations podaje całkowitą liczbę iteracji: domyślnie 1, wartość 2.5 oznacza dwie pełne iteracje i połowę trzeciej, a liczbowe Infinity oznacza brak skończonego limitu iteracji. Przy dodatnim, skończonym duration i skończonym iterations czas aktywny to duration * iterations, bez opóźnień.

easing w opcjach to funkcja CSS opisana tekstem, domyślnie "linear". Zmienia przebieg postępu w całej iteracji, nie jej czas trwania. easing w obiekcie klatki działa od tej klatki do następnej; oba ustawienia mogą działać jednocześnie.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>WAAPI keyframes and timing</title>
<script>
  (() => {
    const element = document.createElement("div");
    const keyframes = [
      { opacity: 0 },
      { opacity: 1, easing: "ease-in" },
      { opacity: 0 },
    ];
    const animation = element.animate(keyframes, {
      duration: 600,
      easing: "ease-in-out",
      iterations: 2.5,
    });

    const effect = animation.effect;
    const { duration, easing, iterations, activeDuration } = effect.getComputedTiming();
    const offsets = effect.getKeyframes().map(frame => frame.computedOffset);
    console.log(`Offsets: ${offsets.join(", ")}`);
    console.log(`${duration} ms × ${iterations} = ${activeDuration} ms; easing: ${easing}`);
    animation.cancel();
  })();
</script>
</html>

Wynik

Offsets: 0, 0.5, 1
600 ms × 2.5 = 1500 ms; easing: ease-in-out

Zapisz przykład jako plik HTML, otwórz go w przeglądarce obsługującej WAAPI i sprawdź konsolę deweloperską. Element nie jest wstawiany na stronę: przykład wypisuje obliczone pozycje i parametry czasowe bez czekania, po czym anuluje animację.

Powiązane lekcje

  • JavaScript · Lekcja 29 · Średniozaawansowany · Wersja: 3

Źródła