CKTIS / CSS
animation-iteration-count: úplné aj čiastočné opakovania
Ovládajte celkový počet cyklov vrátane zlomkových hodnôt a neobmedzeného opakovania.
Verzia: CSS Modules
Syntax
animation-iteration-count: 2.5;animation-iteration-count prijíma nezáporné číslo alebo infinite; počiatočná hodnota je 1. Číslo vyjadruje celkový počet iterácií, nie ďalšie opakovania po prvom cykle. Zlomková hodnota 2.5 znamená dva úplné cykly a polovicu nasledujúceho. Záporné čísla sú neplatné. Počty oddelené čiarkami zodpovedajú položkám animation-name; kratší zoznam sa podľa potreby opakuje.
Pri bežnej časovej animácii s konečnými hodnotami je aktívna doba animation-duration násobená počtom; animation-delay sa medzi cyklami neopakuje. Smer určuje priebeh každého cyklu, takže výplň forwards nemusí zachovať snímku 100%. Počet 0 je platný a vytvára okamžitý aktívny interval; dĺžka 0s zostáva okamžitá aj pri infinite. Skutočne sa opakujúca animácia potrebuje kladnú dĺžku a infinite nemá prirodzený konečný bod, v ktorom by začala výplň forwards.
Príklad odčíta cykly nepriehľadnosti s dĺžkou 1s v čase 2750ms s výplňou forwards. Bežný počet 2.5 už skončil na nepriehľadnosti 0.5 s aktívnou dobou 2500ms. Dva cykly alternate končia na nepriehľadnosti 0 a 2000ms. Nulový počet zachová počiatočnú hodnotu 0, kým infinite pokračuje v treťom cykle na nepriehľadnosti 0.75. Uvádzané indexy aktuálnej iterácie sa počítajú od nuly: 2, 1, 0 a 2; nie sú to samotné hodnoty počtu CSS.
Príklady
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'));Výsledok
opacity=0.5,0,0,0.75 active=2500,2000,0,Infinity iterations=2,1,0,2 negative=false; fractional=true
Vykonané v Chromium 157.0.8103.51 so skutočnými animáciami CSS a vypočítaným časovaním. Príklad overuje konečný, zlomkový, nulový a nekonečný počet v jednom okamihu, nie nekonečné prehrávanie alebo počty udalostí. Ak opakovaný pohyb rozptyľuje, ponúknite pauzu alebo variant s obmedzeným pohybom.