Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje