CKTIS / JavaScript
WAAPI: масив от ключови кадри и настройки за време
Подай масив от ключови кадри на `Element.animate()` и задай отделно продължителността на една итерация, хода ѝ и общия брой итерации.
Версия: Current web platform; runtime support varies
Синтаксис
element.animate(keyframes, { duration, easing, iterations })
element.animate(keyframes, duration)element.animate(keyframes, options) създава и стартира анимация върху DOM елемент и връща обекта Animation. Методът и настройките му за време са част от Web Animations API (WAAPI), а не от ECMAScript 2024 или друго издание на ECMAScript. Наличността им зависи от средата за изпълнение.
В масива от ключови кадри всеки обект задава стойности на CSS свойства, които могат да се анимират, например opacity, в една точка от итерацията. offset задава позицията на тази точка между 0 и 1 включително. Изрично зададените стойности на offset трябва да са в ненамаляващ ред. Пропуснатите позиции се разпределят равномерно: три кадъра без offset получават 0, 0.5 и 1. Един обект с масиви от стойности по свойства, например { opacity: [0, 1] }, е друг поддържан формат.
Числовата настройка duration задава продължителността на една итерация в милисекунди. Число като втори аргумент е съкратен запис, който задава само duration. iterations е общият брой итерации: по подразбиране 1, 2.5 означава две пълни итерации и половината от третата, а числовата стойност Infinity не поставя краен предел. При положителна крайна продължителност и краен брой итерации активната продължителност е duration * iterations, без закъсненията.
В настройките easing е CSS функция за хода на анимацията, записана като низ, по подразбиране "linear". Тя променя хода на цялата итерация, но не и продължителността ѝ. easing в ключов кадър действа от този кадър до следващия; двете настройки могат да се съчетават.
Примери
<!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>Резултат
Offsets: 0, 0.5, 1 600 ms × 2.5 = 1500 ms; easing: ease-in-out
Запази примера като HTML файл, отвори го в браузър, който поддържа WAAPI, и провери изхода в конзолата за разработчици. Елементът не се добавя към страницата: примерът извежда изчислените позиции и времеви стойности без изчакване, след което отменя анимацията.
Свързани уроци
- JavaScript · Урок 29 · Средно · Версия: 3