Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

animation-iteration-count: úplná i částečná opakování

Řiďte celkový počet cyklů včetně zlomkových hodnot a neomezeného opakování.

Verze: CSS Modules

Syntaxe

animation-iteration-count: 2.5;

animation-iteration-count přijímá nezáporné číslo nebo infinite; počáteční hodnota je 1. Číslo vyjadřuje celkový počet iterací, nikoli další opakování po prvním cyklu. Zlomková hodnota 2.5 znamená dva úplné cykly a polovinu následujícího. Záporná čísla jsou neplatná. Počty oddělené čárkami odpovídají položkám animation-name; kratší seznam se podle potřeby opakuje.

U běžné časové animace s konečnými hodnotami je aktivní doba animation-duration násobená počtem; animation-delay se mezi cykly neopakuje. Směr určuje průběh každého cyklu, takže výplň forwards nemusí zachovat snímek 100%. Počet 0 je platný a tvoří okamžitý aktivní interval; délka 0s zůstává okamžitá i při infinite. Skutečně se opakující animace potřebuje kladnou délku a infinite nemá přirozený konečný bod, v němž by začala výplň forwards.

Příklad odečítá cykly neprůhlednosti o délce 1s v čase 2750ms s výplní forwards. Běžný počet 2.5 již skončil na neprůhlednosti 0.5 s aktivní dobou 2500ms. Dva cykly alternate končí na neprůhlednosti 0 a 2000ms. Nulový počet zachová počáteční hodnotu 0, zatímco infinite pokračuje ve třetím cyklu na neprůhlednosti 0.75. Uváděné indexy aktuální iterace jsou počítány od nuly: 2, 1, 0 a 2; nejde o samotné hodnoty počtu CSS.

Pří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ýsledek

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

Provedeno v Chromium 157.0.8103.51 se skutečnými animacemi CSS a vypočteným časováním. Příklad ověřuje konečný, zlomkový, nulový a nekonečný počet v jednom okamžiku, nikoli nekonečné přehrávání nebo počty událostí. Pokud opakovaný pohyb rozptyluje, nabídněte pauzu nebo variantu s omezeným pohybem.

Zdroje