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
/* 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 de0squ'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 initiale | 0s |
|---|---|
| Applicabilité | tous les éléments, ainsi que les pseudo-éléments ::before et ::after |
| Héritée | non |
| Valeur calculée | comme défini |
| Type d'animation | Non animable |
Syntaxe formelle
transition-duration =
<time [0s,∞]>#
Exemples
>Exemple illustrant différentes durées
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
.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
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
- Utiliser les transitions CSS
- La propriété
transition - La propriété
transition-property - La propriété
transition-timing-function - La propriété
transition-delay - L'interface API
TransitionEvent