CKTIS / CSS
animation-iteration-count : répétitions entières et partielles
Contrôlez le nombre total de cycles, y compris les valeurs fractionnaires et les répétitions indéfinies.
Version : CSS Modules
Syntaxe
animation-iteration-count: 2.5;animation-iteration-count accepte un nombre positif ou nul, ou infinite ; sa valeur initiale est 1. Ce nombre est le total des itérations, pas le nombre de répétitions supplémentaires après un premier cycle. Une valeur fractionnaire comme 2.5 signifie deux cycles complets et la moitié du suivant. Les nombres négatifs sont invalides. Les nombres séparés par des virgules correspondent aux entrées de animation-name ; une liste plus courte se répète si nécessaire.
Pour une animation temporelle ordinaire avec des valeurs finies, la durée active est animation-duration multipliée par le nombre d’itérations ; animation-delay ne se répète pas entre les cycles. La direction détermine le sens de chaque cycle : le remplissage forwards ne conserve donc pas nécessairement l’image clé à 100%. Un nombre de 0 est valide et crée un intervalle actif instantané ; une durée de 0s reste aussi instantanée avec infinite. Une animation réellement répétée nécessite une durée positive, et infinite ne crée pas de point final naturel à partir duquel le remplissage forwards commencerait.
L’exemple échantillonne des cycles d’opacité de 1s à 2750ms avec le remplissage forwards. Le nombre normal 2.5 a terminé à l’opacité 0.5 avec une durée active de 2500ms. Deux cycles alternate finissent à l’opacité 0 et à 2000ms. Un nombre nul remplit avec la valeur initiale 0, tandis que infinite se trouve encore dans son troisième cycle à l’opacité 0.75. Les indices d’itération courante rapportés partent de zéro : 2, 1, 0 et 2 ; ce ne sont pas les valeurs du compteur CSS lui-même.
Exemples
const style=document.createElement('style');style.textContent='@keyframes count-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const make=(count,direction='normal')=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:count-demo;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:forwards;animation-play-state:paused';el.style.animationIterationCount=count;el.style.animationDirection=direction;document.body.append(el);return {el,animation:el.getAnimations()[0]}};
const rows=[make('2.5'),make('2','alternate'),make('0'),make('infinite')];
for(const row of rows)row.animation.currentTime=2750;
console.log('opacity='+rows.map(({el})=>getComputedStyle(el).opacity).join(','));
console.log('active='+rows.map(({animation})=>animation.effect.getComputedTiming().activeDuration).join(','));
console.log('iterations='+rows.map(({animation})=>animation.effect.getComputedTiming().currentIteration).join(','));
console.log('negative='+CSS.supports('animation-iteration-count','-1')+'; fractional='+CSS.supports('animation-iteration-count','2.5'));Résultat
opacity=0.5,0,0,0.75 active=2500,2000,0,Infinity iterations=2,1,0,2 negative=false; fractional=true
Exécuté dans Chromium 157.0.8103.51 avec de véritables animations CSS et les paramètres temporels calculés. L’exemple vérifie les nombres finis, fractionnaires, nuls et infinis à un instant donné, pas une exécution éternelle ni le nombre d’événements. Prévoyez une pause ou une variante réduisant le mouvement lorsque sa répétition risque de distraire.