Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

animation-duration : la durée d’un cycle

Définissez la durée d’une itération d’une animation temporelle, indépendamment du délai et du nombre de répétitions.

Version : CSS Modules

Syntaxe

animation-duration: 1s, 250ms;

animation-duration fixe la durée d’une itération, pas la durée totale de toutes les répétitions ni le délai initial. Utilisez un temps positif ou nul avec s ou ms ; un temps négatif ou un nombre non nul sans unité est invalide. Les valeurs séparées par des virgules correspondent aux entrées de animation-name ; une liste de durées plus courte se répète pour couvrir tous les noms. Pour une animation temporelle ordinaire, la durée multipliée par animation-iteration-count donne la durée active, tandis que animation-delay reste distinct.

CSS Animations Level 2 définit auto comme valeur initiale. Sur la ligne temporelle du document, auto se comporte comme 0s ; la restitution du style résolu compatible avec les anciennes règles peut afficher 0s. Zéro ne signifie pas absence d’animation : son intervalle actif est instantané, les événements de début et de fin peuvent toujours se produire, et animation-fill-mode détermine un éventuel effet visible avant ou après. Sur une ligne temporelle pilotée par le défilement, auto remplit plutôt la plage concernée en tenant compte des autres paramètres temporels ; le brouillon actuel y traite aussi un temps explicite comme auto. Une animation liée au défilement ne dure donc pas un nombre fixe de secondes réelles.

L’exemple crée des animations linéaires d’opacité en pause et les échantillonne à 500ms. Un cycle de 1s donne 0.5 et un cycle de 2s donne 0.25. Avec le remplissage both et la direction normale par défaut, 0s et auto exposent déjà la valeur finale 1 ; leurs durées d’itération calculées sont nulles. Le navigateur rejette également -1s et la valeur 1 sans unité. Ce sont de véritables lectures de style calculé et de paramètres temporels, pas un compte à rebours ni une affirmation sur la fréquence d’images.

Exemples

const style=document.createElement('style');
style.textContent='@keyframes duration-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const make=duration=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:duration-demo;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';el.style.animationDuration=duration;document.body.append(el);const animation=el.getAnimations()[0];animation.currentTime=500;return {el,animation}};
const rows=['1s','2s','0s','auto'].map(make);
console.log('opacity='+rows.map(({el})=>getComputedStyle(el).opacity).join(','));
console.log('duration='+rows.map(({animation})=>animation.effect.getComputedTiming().duration).join(','));
console.log('negative='+CSS.supports('animation-duration','-1s')+'; unitless='+CSS.supports('animation-duration','1')+'; auto='+CSS.supports('animation-duration','auto'));

Résultat

opacity=0.5,0.25,1,1
duration=1000,2000,0,0
negative=false; unitless=false; auto=true

Exécuté dans Chromium 157.0.8103.51 sur la ligne temporelle du document. L’exemple vérifie la durée temporelle et auto, pas le pilotage par défilement ni la livraison d’événements. L’explication du défilement suit le brouillon actuel CSS Animations Level 2 ; testez cette fonctionnalité séparément dans les navigateurs cibles.

Sources