Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

WAAPI: niz ključnih kadrova i opcije vremenskog tijeka

Proslijedi niz ključnih kadrova metodi `Element.animate()` i u zasebnom objektu opcija odredi trajanje, tijek i ukupan broj iteracija.

Verzija: Current web platform; runtime support varies

Sintaksa

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

element.animate(keyframes, options) stvara i pokreće animaciju na elementu DOM-a te vraća objekt Animation. Metoda i njezine vremenske opcije dio su sučelja Web Animations API (WAAPI), a ne ECMAScripta 2024 ni bilo kojeg drugog izdanja ECMAScripta. Njihova dostupnost ovisi o izvršnom okruženju.

U nizu ključnih kadrova svaki objekt zadaje vrijednosti svojstava CSS-a koja se mogu animirati, kao što je opacity, u jednoj točki iteracije. offset smješta tu točku između 0 i 1, uključujući granice. Izričito zadane vrijednosti offset moraju biti u nepadajućem redoslijedu. Izostavljeni se položaji ravnomjerno raspoređuju: tri kadra bez offset dobivaju 0, 0.5 i 1. Jedan objekt s nizovima vrijednosti po svojstvima, primjerice { opacity: [0, 1] }, drugi je podržani format.

Brojčana opcija duration određuje trajanje jedne iteracije u milisekundama. Broj kao drugi argument kraći je zapis kojim se postavlja samo duration. iterations je ukupan broj iteracija: zadana je vrijednost 1, 2.5 znači dvije pune iteracije i polovicu treće, a brojčana vrijednost Infinity ne postavlja konačnu granicu. Uz pozitivno konačno trajanje i konačan broj iteracija, aktivno trajanje iznosi duration * iterations, bez odgoda.

easing u opcijama jest funkcija tijeka CSS-a zapisana kao znakovni niz, zadano "linear". Mijenja tijek cijele iteracije, ali ne i njezino trajanje. easing u ključnom kadru vrijedi od tog kadra do sljedećeg; obje postavke mogu djelovati zajedno.

Primjeri

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

Spremi primjer kao HTML datoteku, otvori je u pregledniku koji podržava WAAPI i provjeri ispis u razvojnoj konzoli. Element se ne dodaje na stranicu: primjer bez čekanja ispisuje izračunate položaje i vremenske vrijednosti, a zatim otkazuje animaciju.

Povezane lekcije

  • JavaScript · Lekcija 29 · Srednje · Verzija: 3

Izvori