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