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