Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

animation-iteration-count: ripetizioni complete e parziali

Controlla il numero totale di cicli, inclusi valori frazionari e ripetizione indefinita.

Versione: CSS Modules

Sintassi

animation-iteration-count: 2.5;

animation-iteration-count accetta un numero non negativo o infinite; il valore iniziale è 1. Il numero indica tutte le iterazioni, non ripetizioni aggiuntive dopo un primo ciclo. Un valore frazionario come 2.5 significa due cicli interi e metà del successivo. I numeri negativi non sono validi. I conteggi separati da virgole corrispondono alle voci di animation-name; un elenco più corto si ripete quando necessario.

Per una normale animazione temporale con valori finiti, la durata attiva è animation-duration moltiplicata per il conteggio; animation-delay non si ripete tra i cicli. La direzione stabilisce come procede ogni ciclo, quindi il riempimento forwards non deve necessariamente conservare il fotogramma a 100%. Il conteggio 0 è valido e crea un intervallo attivo istantaneo; anche la durata 0s resta istantanea con infinite. Un’animazione che si ripete effettivamente richiede una durata positiva, e infinite non crea un punto finale naturale da cui inizi il riempimento forwards.

L’esempio legge cicli di opacità di 1s a 2750ms con riempimento forwards. Il conteggio normale 2.5 è terminato all’opacità 0.5 con durata attiva 2500ms. Due cicli alternate finiscono all’opacità 0 e a 2000ms. Un conteggio zero riempie con il valore iniziale 0, mentre infinite è ancora nel terzo ciclo all’opacità 0.75. Gli indici dell’iterazione corrente restituiti partono da zero e sono 2, 1, 0 e 2; non sono i valori stessi del conteggio CSS.

Esempi

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'));

Risultato

opacity=0.5,0,0,0.75
active=2500,2000,0,Infinity
iterations=2,1,0,2
negative=false; fractional=true

Eseguito in Chromium 157.0.8103.51 con animazioni CSS reali e tempi calcolati. L’esempio verifica conteggi finiti, frazionari, zero e infiniti in un istante, non l’esecuzione eterna o il numero di eventi. Prevedi una pausa o un’alternativa con movimento ridotto quando il movimento ripetuto può distrarre.

Fonti