CKTIS / CSS
animation-iteration-count: repetições completas e parciais
Controla o número total de ciclos, incluindo valores fracionários e repetição indefinida.
Versão: CSS Modules
Sintaxe
animation-iteration-count: 2.5;animation-iteration-count aceita um número não negativo ou infinite; o valor inicial é 1. O número representa o total de iterações, não repetições adicionais depois de um primeiro ciclo. Um valor fracionário como 2.5 significa dois ciclos completos e metade do seguinte. Números negativos são inválidos. As contagens separadas por vírgulas correspondem às entradas de animation-name; uma lista mais curta repete-se quando necessário.
Numa animação temporal normal com valores finitos, a duração ativa é animation-duration multiplicada pela contagem; animation-delay não se repete entre ciclos. A direção determina como cada ciclo decorre, pelo que o preenchimento forwards não tem de conservar o fotograma de 100%. Uma contagem de 0 é válida e cria um intervalo ativo instantâneo; uma duração de 0s também continua instantânea com infinite. Uma animação que realmente se repete precisa de duração positiva, e infinite não cria um ponto final natural onde comece o preenchimento forwards.
O exemplo consulta ciclos de opacidade de 1s aos 2750ms com preenchimento forwards. A contagem normal 2.5 terminou com opacidade 0.5 e duração ativa 2500ms. Dois ciclos alternate acabam com opacidade 0 e aos 2000ms. Uma contagem zero preenche com o valor inicial 0, enquanto infinite ainda está no terceiro ciclo com opacidade 0.75. Os índices de iteração atual apresentados começam em zero e são 2, 1, 0 e 2; não são os próprios valores da contagem CSS.
Exemplos
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'));Resultado
opacity=0.5,0,0,0.75 active=2500,2000,0,Infinity iterations=2,1,0,2 negative=false; fractional=true
Executado no Chromium 157.0.8103.51 com animações CSS reais e parâmetros temporais calculados. O exemplo verifica contagens finitas, fracionárias, zero e infinitas num instante, não execução eterna nem quantidades de eventos. Fornece uma pausa ou uma alternativa com movimento reduzido quando o movimento repetido possa distrair.