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