Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

WAAPI: pole kľúčových snímok a možnosti časovania

Odovzdajte metóde `Element.animate()` pole kľúčových snímok a v samostatnom objekte nastavte trvanie iterácie, jej priebeh a celkový počet iterácií.

Verzia: Current web platform; runtime support varies

Syntax

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

element.animate(keyframes, options) vytvorí a spustí animáciu prvku DOM a vráti objekt Animation. Metóda a jej možnosti časovania patria do Web Animations API (WAAPI), nie do ECMAScriptu 2024 ani do žiadneho iného vydania ECMAScriptu. Ich dostupnosť závisí od prostredia, v ktorom kód beží.

V poli kľúčových snímok každý objekt určuje hodnoty animovateľných vlastností CSS, napríklad opacity, v jednom bode iterácie. offset určuje polohu bodu od 0 do 1 vrátane. Výslovne zadané hodnoty offset musia byť v neklesajúcom poradí. Chýbajúce polohy sa rozložia rovnomerne: tri snímky bez offset dostanú 0, 0.5 a 1. Jeden objekt s poľami hodnôt jednotlivých vlastností, napríklad { opacity: [0, 1] }, je iný podporovaný formát.

Číselná voľba duration udáva trvanie jednej iterácie v milisekundách. Číslo ako druhý argument je skrátený zápis, ktorý nastaví iba duration. iterations je celkový počet iterácií: predvolená hodnota je 1, 2.5 znamená dve celé iterácie a polovicu tretej a číselná hodnota Infinity neurčuje konečnú hranicu. Pri kladnom konečnom trvaní a konečnom počte iterácií je aktívne trvanie duration * iterations, bez oneskorení.

Voľba easing je funkcia priebehu CSS zapísaná ako reťazec, predvolene "linear". Mení priebeh celej iterácie, nie jej trvanie. easing v kľúčovej snímke platí od tejto snímky po nasledujúcu; obe nastavenia môžu pôsobiť súčasne.

Prí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ýsledok

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

Uložte príklad ako súbor HTML, otvorte ho v prehliadači s podporou WAAPI a skontrolujte výstup vo vývojárskej konzole. Prvok sa nevkladá do stránky: príklad bez čakania vypíše vypočítané polohy a časové údaje a potom animáciu zruší.

Súvisiace lekcie

  • JavaScript · Lekcia 29 · Stredne pokročilá · Verzia: 3

Zdroje