Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Propriété CSS transition-duration

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 septembre 2015.

La propriété CSS transition-duration définit le nombre de secondes ou de millisecondes que doit durer une animation. La valeur par défaut, 0s, indique qu'il n'y a aucune animation.

Vous pouvez définir plusieurs durées ; chaque durée est appliquée à la propriété correspondante telle que définie dans la propriété transition-property, qui agit comme une liste principale. Si le nombre de durées définies est inférieur à celui de la liste principale, l'agent utilisateur répète la liste des durées. Si le nombre de durées définies est supérieur à celui de la liste principale, la liste est tronquée à la bonne taille. Dans les deux cas, la déclaration CSS reste valide.

Exemple interactif

transition-duration: 500ms;
transition-property: margin-right;
transition-duration: 2s;
transition-property: background-color;
transition-duration: 2s;
transition-property: margin-right, color;
transition-duration: 3s, 1s;
transition-property: margin-right, color;
<section id="default-example">
  <div id="example-element">Survolez pour voir<br />la transition.</div>
</section>
#example-element {
  background-color: #e4f0f5;
  color: black;
  padding: 1rem;
  border-radius: 0.5rem;
  font: 1em monospace;
  width: 100%;
  transition: margin-right 2s;
}

#default-example:hover > #example-element {
  background-color: #990099;
  color: white;
  margin-right: 40%;
}

Syntaxe

css
/* Valeurs de type <time> */
transition-duration: 6s;
transition-duration: 120ms;
transition-duration: 1s, 15s;
transition-duration: 10s, 30s, 230ms;

/* Valeurs globales */
transition-duration: inherit;
transition-duration: initial;
transition-duration: revert;
transition-duration: revert-layer;
transition-duration: unset;

Valeurs

<time>

Une valeur <time> qui définit la durée que doit prendre l'animation pour changer la valeur d'une propriété (entre l'ancienne valeur et la nouvelle). Une durée de 0s qu'aucune transition n'est appliquée et que le passage d'un état à l'autre est instantané. Si la valeur utilisée est négative, la déclaration est considérée comme invalide.

Définition formelle

Valeur initiale0s
Applicabilitétous les éléments, ainsi que les pseudo-éléments ::before et ::after
Héritéenon
Valeur calculéecomme défini
Type d'animationNon animable

Syntaxe formelle

transition-duration = 
<time [0s,∞]>#

Exemples

Exemple illustrant différentes durées

HTML

html
<div class="boite duree-1">0,5 secondes</div>

<div class="boite duree-2">2 secondes</div>

<div class="boite duree-3">4 secondes</div>

<button id="changer">Changer</button>

CSS

css
.boite {
  margin: 20px;
  padding: 10px;
  display: inline-block;
  width: 100px;
  height: 100px;
  background-color: red;
  font-size: 18px;
  transition-property: background-color font-size transform color;
  transition-timing-function: ease-in-out;
}

.transformed-state {
  transform: rotate(270deg);
  background-color: blue;
  color: yellow;
  font-size: 12px;
  transition-property: background-color font-size transform color;
  transition-timing-function: ease-in-out;
}

.duree-1 {
  transition-duration: 0.5s;
}

.duree-2 {
  transition-duration: 2s;
}

.duree-3 {
  transition-duration: 4s;
}

JavaScript

js
function change() {
  const elements = document.querySelectorAll("div.boite");
  for (let element of elements) {
    element.classList.toggle("transformed-state");
  }
}

const changeButton = document.querySelector("#changer");
changeButton.addEventListener("click", change);

Résultat

Spécifications

Spécification
CSS Transitions Module Level 1
# transition-duration-property

Compatibilité des navigateurs

Voir aussi