Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

WAAPI: tabela ključnih sličic in možnosti časovnega poteka

Metodi `Element.animate()` podaj tabelo ključnih sličic, v ločenem objektu z možnostmi pa določi trajanje, potek in skupno število ponovitev.

Različica: Current web platform; runtime support varies

Sintaksa

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

element.animate(keyframes, options) ustvari in zažene animacijo na elementu DOM ter vrne objekt Animation. Metoda in njene možnosti časovnega poteka so del vmesnika Web Animations API (WAAPI), ne standarda ECMAScript 2024 ali katere koli druge izdaje ECMAScripta. Njihova razpoložljivost je odvisna od izvajalnega okolja.

V tabeli ključnih sličic vsak objekt poda vrednosti lastnosti CSS, ki jih je mogoče animirati, na primer opacity, v eni točki ponovitve. offset postavi to točko med 0 in 1, vključno z mejama. Izrecno podane vrednosti offset morajo biti v nepadajočem vrstnem redu. Manjkajoči položaji se razporedijo enakomerno: tri sličice brez offset dobijo 0, 0.5 in 1. En sam objekt s tabelami vrednosti po lastnostih, na primer { opacity: [0, 1] }, je druga podprta oblika.

Številska možnost duration označuje trajanje ene ponovitve v milisekundah. Število kot drugi argument je krajši zapis, ki nastavi samo duration. iterations je skupno število ponovitev: privzeto 1, 2.5 pomeni dve polni ponovitvi in polovico tretje, številska vrednost Infinity pa ne postavi končne meje. Pri pozitivnem končnem trajanju in končnem številu ponovitev je aktivno trajanje duration * iterations, brez zakasnitev.

easing v objektu z možnostmi je funkcija poteka CSS, zapisana kot niz, privzeto "linear". Spremeni potek celotne ponovitve, ne njenega trajanja. easing v ključni sličici velja od te sličice do naslednje; obe nastavitvi lahko delujeta skupaj.

Primeri

<!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>

Rezultat

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

Shrani primer kot datoteko HTML, odpri jo v brskalniku, ki podpira WAAPI, in preveri izpis v razvijalski konzoli. Element se ne doda na stran: primer brez čakanja izpiše izračunane položaje in časovne vrednosti ter nato prekliče animacijo.

Povezane lekcije

  • JavaScript · Lekcija 29 · Srednja · Različica: 3

Viri