Element : évènement animationiteration

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis décembre 2019.

En savoir plus
Voir la compatibilité complète

L'évènement animationiteration est déclenché lorsqu'une itération d'une animation CSS se termine et qu'une autre commence. Cet évènement ne se produit pas en même temps que l'évènement animationend, et ne se produit donc pas pour les animations avec un animation-iteration-count de 1.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènements.

addEventListener("animationiteration", (event) => { })

onanimationiteration = (event) => { }

Type d'évènement

Un objet AnimationEvent. Hérite de l'objet Event.

Propriétés de l'évènement

Hérite également des propriétés de son parent Event.

AnimationEvent.animationName Lecture seule: Une chaîne de caractères contenant la valeur de la animation-name qui a généré l'animation.
AnimationEvent.elapsedTime Lecture seule: Un float indiquant le temps pendant lequel l'animation a été exécutée, en secondes, lorsque cet évènement a été déclenché, à l'exclusion du temps pendant lequel l'animation était en pause. Pour un évènement animationstart, elapsedTime est 0.0 sauf s'il y avait une valeur négative pour animation-delay, auquel cas l'évènement est déclenché avec elapsedTime contenant (-1 * delay).
AnimationEvent.pseudoElement Lecture seule: Une chaîne de caractères, commençant par '::', contenant le nom du pseudo-élément sur lequel l'animation s'exécute. Si l'animation ne s'exécute pas sur un pseudo-élément mais sur l'élément, une chaîne de caractères vide : ''.

Exemples

Ce code utilise animationiteration pour suivre le nombre d'itérations qu'une animation a effectuées :

const anime = document.querySelector(".anime");

let compteIteration = 0;

anime.addEventListener("animationiteration", () => {
  compteIteration++;
  console.log(`Nombre d'itérations de l'animation : ${compteIteration}`);
});

Le même exemple, mais en utilisant la propriété de gestionnaire d'évènements onanimationiteration :

const anime = document.querySelector(".anime");

let compteIteration = 0;

anime.onanimationiteration = () => {
  compteIteration++;
  console.log(`Nombre d'itérations de l'animation : ${compteIteration}`);
};

Exemple interactif

HTML

html

<div class="exemple-animation">
  <div class="conteneur">
    <p class="animation">
      Vous avez choisi une nuit froide pour visiter notre planète.
    </p>
  </div>
  <button class="activer" type="button">Activer l'animation</button>
  <div class="journal-event"></div>
</div>

CSS

css

.conteneur {
  height: 3rem;
}

.journal-event {
  width: 25rem;
  height: 2rem;
  border: 1px solid black;
  margin: 0.2rem;
  padding: 0.2rem;
}

.animation.active {
  animation-duration: 2s;
  animation-name: slide-in;
  animation-iteration-count: 2;
}

@keyframes slide-in {
  from {
    transform: translateX(100%) scaleX(3);
  }
  to {
    transform: translateX(0) scaleX(1);
  }
}

JavaScript

const animation = document.querySelector("p.animation");
const journalEventAnimation = document.querySelector(
  ".exemple-animation>.journal-event",
);
const appliquerAnimation = document.querySelector(
  ".exemple-animation>button.activer",
);
let compteIteration = 0;

animation.addEventListener("animationstart", () => {
  journalEventAnimation.textContent = `${journalEventAnimation.textContent}'animation démarrée' `;
});

animation.addEventListener("animationiteration", () => {
  compteIteration++;
  journalEventAnimation.textContent = `${journalEventAnimation.textContent}'itérations de l'animation : ${compteIteration}' `;
});

animation.addEventListener("animationend", () => {
  journalEventAnimation.textContent = `${journalEventAnimation.textContent}'animation terminée'`;
  animation.classList.remove("active");
  appliquerAnimation.textContent = "Activer l'animation";
});

animation.addEventListener("animationcancel", () => {
  journalEventAnimation.textContent = `${journalEventAnimation.textContent}'animation annulée'`;
});

appliquerAnimation.addEventListener("click", () => {
  animation.classList.toggle("active");
  journalEventAnimation.textContent = "";
  compteIteration = 0;
  const active = animation.classList.contains("active");
  appliquerAnimation.textContent = active
    ? "Annuler l'animation"
    : "Activer l'animation";
});

Résultat

Spécifications

Spécification
CSS Animations Level 1 # eventdef-globaleventhandlers-animationiteration

Compatibilité des navigateurs

Voir aussi

Les animations CSS
Utiliser les animations CSS
L'interface AnimationEvent
Évènements associés : animationstart, animationend, animationcancel

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 11 juil. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu