База знанияИзпитен център
BGБългарски
Избери език13

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

Източници