CKTIS / CSS
animation-iteration-count: repeticiones completas y parciales
Controla el número total de ciclos, incluidos los valores fraccionarios y la repetición indefinida.
Versión: CSS Modules
Sintaxis
animation-iteration-count: 2.5;animation-iteration-count acepta un número no negativo o infinite; su valor inicial es 1. El número indica el total de iteraciones, no las repeticiones adicionales tras un primer ciclo. Un valor fraccionario como 2.5 significa dos ciclos completos y la mitad del siguiente. Los números negativos son inválidos. Los contadores separados por comas se emparejan con las entradas de animation-name; una lista más corta se repite cuando es necesario.
Para una animación temporal normal con valores finitos, la duración activa es animation-duration multiplicada por el contador; animation-delay no se repite entre ciclos. La dirección determina cómo se reproduce cada ciclo, por lo que el relleno forwards no tiene por qué conservar el fotograma de 100%. Un contador de 0 es válido y crea un intervalo activo instantáneo; una duración de 0s sigue siendo instantánea incluso con infinite. Una animación que realmente se repita necesita una duración positiva, e infinite no crea un punto final natural en el que empiece el relleno forwards.
El ejemplo consulta ciclos de opacidad de 1s en 2750ms con relleno forwards. El contador normal 2.5 ha terminado en opacidad 0.5 y duración activa 2500ms. Dos ciclos alternate terminan en opacidad 0 y 2000ms. Un contador cero rellena con el valor inicial 0, mientras que infinite sigue en su tercer ciclo con opacidad 0.75. Los índices de iteración actual informados empiezan en cero y son 2, 1, 0 y 2; no son los propios valores del contador CSS.
Ejemplos
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
Ejecutado en Chromium 157.0.8103.51 con animaciones CSS reales y temporización calculada. El ejemplo verifica contadores finitos, fraccionarios, cero e infinitos en un instante, no la ejecución eterna ni la cantidad de eventos. Ofrece pausa o una alternativa con menos movimiento cuando el movimiento repetido pueda distraer.