Propriété CSSAnimations

animation-name

Indique quelles images clés @keyframes un élément doit jouer.

Valeur initiale
none
Héritée
Non
Animable
non
S’applique à
tous les éléments ainsi que les pseudo-éléments ::before et ::after
JavaScript
element.style.animationName = "slide"
Sur cette page

Exemple

#
CSS
.badge {
  animation-name: pop;
  animation-duration: 0.6s;
}

@keyframes pop {
  from { transform: scale(0.6); opacity: 0; }
  to { transform: scale(1); opacity: 1; }
}
Aperçu

Définition et utilisation

#

La propriété animation-name relie un élément à une animation définie dans une règle @keyframes. Le nom seul ne suffit pas : l’animation ne démarre que si elle a aussi une durée (animation-duration) supérieure à zéro.

On peut indiquer plusieurs noms séparés par des virgules. Chaque animation s’exécute alors en parallèle, et les autres propriétés d’animation (durée, délai, nombre de répétitions) sont associées dans l’ordre aux noms de la liste.

Si le nom ne correspond à aucune règle @keyframes, rien ne se passe et le navigateur ne signale aucune erreur. Quand une animation « ne fonctionne pas », vérifiez donc d’abord l’orthographe.

Syntaxe

#
Syntaxe
animation-name: none | nom-des-images-clés [, nom-des-images-clés]*;

Valeurs

#
  • none

    Aucune animation. Utile pour désactiver une animation héritée d’une autre règle.
  • slide

    nom-des-images-clés

    Le nom de votre propre règle @keyframes. Ici, l’élément se déplace vers la droite puis revient.
  • pulse

    nom-des-images-clés

    Une autre règle @keyframes : l’élément pulse et change de couleur.
  • slide, spin

    liste de noms

    Deux animations à la fois. Les deux s’exécutent en parallèle et leurs transformations s’écrasent mutuellement, c’est donc la dernière de la liste qui l’emporte.

Valeurs en pratique

#

none

Aucune animation. Utile pour désactiver une animation héritée d’une autre règle.
.demo .box { animation-name: none; }

slide

Le nom de votre propre règle @keyframes. Ici, l’élément se déplace vers la droite puis revient.
.demo .box { animation-name: slide; }

pulse

Une autre règle @keyframes : l’élément pulse et change de couleur.
.demo .box { animation-name: pulse; }

slide, spin

Deux animations à la fois. Les deux s’exécutent en parallèle et leurs transformations s’écrasent mutuellement, c’est donc la dernière de la liste qui l’emporte.
.demo .box { animation-name: slide, spin; }

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Donnez aux images clés des noms descriptifs, comme fade-in ou slide-up. Elles sont plus faciles à retrouver dans la feuille de style.
  • Respectez le réglage système qui limite les animations : désactivez-les ou raccourcissez-les dans @media (prefers-reduced-motion: reduce).

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.