CKTIS / JavaScript
WAAPI: pole klíčových snímků a volby časování
Předejte metodě `Element.animate()` pole klíčových snímků a v samostatném objektu nastavte délku iterace, průběh animace a celkový počet iterací.
Verze: Current web platform; runtime support varies
Syntaxe
element.animate(keyframes, { duration, easing, iterations })
element.animate(keyframes, duration)element.animate(keyframes, options) vytvoří a spustí animaci prvku DOM a vrátí objekt Animation. Metoda a její volby časování patří do Web Animations API (WAAPI), nikoli do ECMAScriptu 2024 ani do žádného jiného vydání ECMAScriptu. Jejich dostupnost závisí na prostředí, ve kterém kód běží.
V poli klíčových snímků každý objekt zadává hodnoty animovatelných vlastností CSS, například opacity, v jednom bodě iterace. offset určuje polohu bodu od 0 do 1 včetně. Výslovně zadané hodnoty offset musejí být v neklesajícím pořadí. Chybějící polohy se rozloží rovnoměrně: tři snímky bez offset dostanou 0, 0.5 a 1. Jediný objekt s poli hodnot pro jednotlivé vlastnosti, například { opacity: [0, 1] }, je jiný podporovaný formát.
Číselná volba duration udává délku jedné iterace v milisekundách. Číslo jako druhý argument je zkrácený zápis, který nastaví pouze duration. iterations určuje celkový počet iterací: výchozí hodnota je 1, 2.5 znamená dvě celé iterace a polovinu třetí a číselná hodnota Infinity neklade konečnou mez. Při kladné konečné délce a konečném počtu iterací je aktivní doba duration * iterations, bez prodlev.
Volba easing je funkce průběhu CSS zapsaná jako řetězec, výchozí je "linear". Mění průběh celé iterace, ne její délku. easing v klíčovém snímku platí od tohoto snímku k následujícímu; obě nastavení mohou působit současně.
Příklady
<!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>Výsledek
Offsets: 0, 0.5, 1 600 ms × 2.5 = 1500 ms; easing: ease-in-out
Uložte příklad jako soubor HTML, otevřete ho v prohlížeči s podporou WAAPI a zkontrolujte výstup ve vývojářské konzoli. Prvek se nevkládá do stránky: příklad bez čekání vypíše vypočtené polohy a časové údaje a pak animaci zruší.
Související lekce
- JavaScript · Lekce 29 · Středně pokročilá · Verze: 3