Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

animation-iteration-count: pełne i częściowe powtórzenia

Steruj łączną liczbą cykli, również wartościami ułamkowymi i powtarzaniem bez końca.

Wersja: CSS Modules

Składnia

animation-iteration-count: 2.5;

animation-iteration-count przyjmuje nieujemną liczbę lub infinite; wartość początkowa to 1. Liczba oznacza wszystkie iteracje, a nie dodatkowe powtórzenia po pierwszym cyklu. Wartość ułamkowa, np. 2.5, oznacza dwa pełne cykle i połowę następnego. Liczby ujemne są nieprawidłowe. Liczniki oddzielone przecinkami odpowiadają pozycjom animation-name; krótsza lista jest w razie potrzeby powtarzana.

Dla zwykłej animacji sterowanej czasem i skończonych wartości aktywny czas trwania to animation-duration pomnożone przez licznik; animation-delay nie powtarza się między cyklami. Kierunek określa przebieg każdego cyklu, więc wypełnienie forwards nie musi zachować klatki 100%. Licznik 0 jest poprawny i tworzy chwilowy aktywny przedział; czas 0s pozostaje chwilowy również przy infinite. Rzeczywiście powtarzana animacja potrzebuje dodatniego czasu, a infinite nie tworzy naturalnego punktu końcowego, od którego zaczyna działać forwards.

Przykład odczytuje cykle przezroczystości o długości 1s w chwili 2750ms przy wypełnieniu forwards. Zwykły licznik 2.5 zakończył już odtwarzanie z przezroczystością 0.5 i aktywnym czasem 2500ms. Dwa cykle alternate kończą się na przezroczystości 0 i 2000ms. Licznik zerowy zachowuje wartość początkową 0, a infinite nadal jest w trzecim cyklu z przezroczystością 0.75. Raportowane indeksy bieżącej iteracji są liczone od zera i wynoszą 2, 1, 0 oraz 2; nie są to same wartości licznika CSS.

Przykłady

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'));

Wynik

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

Wykonano w Chromium 157.0.8103.51 na rzeczywistych animacjach CSS i obliczonych parametrach czasu. Przykład sprawdza skończony, ułamkowy, zerowy i nieskończony licznik w jednej chwili, a nie wieczne odtwarzanie czy liczbę zdarzeń. Zapewnij pauzę lub wariant ograniczonego ruchu, gdy powtarzany ruch może rozpraszać.

Źródła