CKTIS / CSS
animation-iteration-count: ganze und teilweise Wiederholungen
Steuere die Gesamtzahl der Durchläufe einschließlich gebrochener Zahlen und unbegrenzter Wiederholung.
Version: CSS Modules
Syntax
animation-iteration-count: 2.5;animation-iteration-count akzeptiert eine nichtnegative Zahl oder infinite; der Anfangswert ist 1. Die Zahl bezeichnet die Gesamtzahl der Iterationen, nicht zusätzliche Wiederholungen nach einem ersten Durchlauf. Ein Bruchwert wie 2.5 bedeutet zwei ganze Durchläufe und die Hälfte des nächsten. Negative Zahlen sind ungültig. Kommagetrennte Zähler entsprechen den Einträgen von animation-name; eine kürzere Zählerliste wird bei Bedarf wiederholt.
Bei einer gewöhnlichen zeitgesteuerten Animation mit endlichen Werten ist die aktive Dauer animation-duration multipliziert mit dem Zähler; animation-delay wird nicht zwischen den Durchläufen wiederholt. Die Richtung bestimmt, wie jeder Durchlauf abgespielt wird, weshalb die forwards-Füllung nicht unbedingt den 100%-Keyframe behält. Ein Zähler von 0 ist gültig und erzeugt ein augenblickliches aktives Intervall; eine Dauer von 0s bleibt auch mit infinite augenblicklich. Eine tatsächlich wiederholte Animation benötigt eine positive Dauer, und infinite erzeugt keinen natürlichen Endpunkt für den Beginn der forwards-Füllung.
Das Beispiel liest 1s-Deckkraftdurchläufe bei 2750ms mit forwards-Füllung aus. Der normale Zähler 2.5 ist bei Deckkraft 0.5 und einer aktiven Dauer von 2500ms beendet. Zwei alternate-Durchläufe enden bei Deckkraft 0 und 2000ms. Ein Zähler von null füllt mit dem Startwert 0, während infinite noch im dritten Durchlauf bei Deckkraft 0.75 liegt. Die ausgegebenen Indizes der aktuellen Iteration beginnen bei null und lauten 2, 1, 0 und 2; sie sind nicht die CSS-Zählerwerte selbst.
Beispiele
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'));Ergebnis
opacity=0.5,0,0,0.75 active=2500,2000,0,Infinity iterations=2,1,0,2 negative=false; fractional=true
Ausgeführt in Chromium 157.0.8103.51 mit tatsächlichen CSS-Animationen und berechneten Zeitparametern. Das Beispiel prüft endliche, gebrochene, null und unendliche Zähler an einem Zeitpunkt, nicht endlose Ausführung oder Ereigniszahlen. Biete eine Pause oder eine Variante mit weniger Bewegung an, wenn wiederholte Bewegung ablenken könnte.