JS об'єкт AnimationEvent

Загальний опис

AnimationEvent – це події, що активуються під час виконання CSS-анімацій. Вони включають такі події, як animationstart (початок анімації), animationiteration (кожна нова ітерація анімації) та animationend (завершення анімації). З їх допомогою JavaScript може реагувати на зміни стану анімації елементів у DOM, створюючи інтерактивні та динамічні ефекти.

Щоб використати AnimationEvent, спочатку потрібно додати CSS-анімацію до елемента. Наприклад, якщо у CSS створена анімація для елемента з ключовими кадрами, JavaScript може реагувати на етапи цієї анімації, використовуючи події, описані нижче.

Для відстеження початку анімації застосовується animationstart:

element.addEventListener('animationstart', (event) => {
  console.log('Анімація почалась для елемента:', event.target);
});

Цей код виконується, коли анімація стартує, дозволяючи, наприклад, змінювати або завантажувати певні ресурси на початку анімації.

Подія animationiteration відслідковує кожну нову ітерацію (повторення) анімації:

element.addEventListener('animationiteration', (event) => {
  console.log('Ітерація анімації для елемента:', event.target);
});

Це дозволяє виконувати код кожного разу, коли анімація починається заново, що корисно для циклічних анімацій.

Подія animationend спрацьовує, коли анімація завершується:

element.addEventListener('animationend', (event) => {
  console.log('Анімація завершилась для елемента:', event.target);
});

animationend можна використовувати для повернення елемента у вихідний стан або очищення ресурсів після завершення анімації. Під час роботи з AnimationEvent варто враховувати об’єкт event, який містить властивості, такі як elapsedTime (час з моменту початку анімації) і animationName (назва анімації). Ці властивості корисні для контролю анімації, коли необхідно реагувати на певні ефекти, що виникають під час роботи анімації.

правити

Порада

event.elapsedTime може бути корисним для отримання інформації про тривалість анімації, що дозволяє контролювати або логувати час виконання анімації. Використовуйте console.log(event.elapsedTime), щоб швидко оцінити продуктивність анімації.

автор: Bond правити

Порада

Якщо потрібна анімація на кожній ітерації циклу, використовуйте animationiteration, щоб уникнути обчислень між ітераціями, зменшуючи навантаження. Це дозволяє додавати ефекти або змінювати властивості елемента тільки на певних етапах.

автор: Bond правити

Порада

Щоб зупиняти анімацію умовно, наприклад, при певній кількості ітерацій, можна додати лічильник, який збільшується на animationiteration і припиняє анімацію, коли досягнуто потрібного значення, використовуючи CSS або JavaScript.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

element.addEventListener('animationstart', function(event) { /* Код для початку анімації */ });
element.addEventListener('animationiteration', function(event) { /* Код для повторення анімації */ });
element.addEventListener('animationend', function(event) { /* Код для завершення анімації */ });

властивості

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	43	5	9	30	12

Підтримка: мобільні переглядачі

Переглядач
	43	43	5	9

Підтримка: серверні переглядачі

Переглядач
	-	-

Приклади

+ запропонувати свій приклад у пісочниці

<div id="demo-element">Демонстраційний елемент</div>

const element = document.getElementById('demo-element');

let counter = 0;
element.addEventListener('animationend', (event) => {
  if (counter < 5) {
    event.target.style.animation = 'none';
    setTimeout(() => event.target.style.animation = '', 0); // Перезапуск анімації
    counter++;
  }
});

<div id="demo-element">Демонстраційний елемент</div>

const element = document.getElementById('demo-element');

element.addEventListener('animationiteration', (event) => {
  if (event.elapsedTime > 2) {
    event.target.classList.add('highlight'); // Додає клас після першої ітерації
  }
});