KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

animation-iteration-count: hoeveel cycli worden afgespeeld

Gebruik een niet-negatief aantal of infinite; een gebroken aantal stopt midden in een cyclus.

Versie: CSS Modules

Syntax

animation-iteration-count: 2.5;

animation-iteration-count is een niet-negatief getal of infinite; de standaardwaarde is 1. Het getal geeft het totale aantal cycli aan, niet het aantal extra herhalingen. De waarde 2.5 speelt twee volledige cycli en vervolgens een halve cyclus af. Een negatief getal is ongeldig. Waarden in een lijst met komma’s horen bij animation-name; een kortere lijst wordt herhaald.

Op een gewone tijdlijn is de actieve duur bij een eindig aantal cycli de cyclusduur maal het aantal cycli; een vertraging wordt niet vóór elke herhaling opnieuw ingevoegd. Door animation-direction hoeft de eindwaarde met forwards niet die van het keyframe bij 100% te zijn. Nul is geldig en geeft een ogenblikkelijke actieve fase. Ook een cyclusduur van 0s blijft ogenblikkelijk bij infinite; voor een zichtbaar voortdurende herhaling is een positieve duur nodig. Een daadwerkelijk oneindige animatie heeft geen eindig eindpunt waarna forwards actief wordt.

Het voorbeeld neemt cycli van 1s en bekijkt de animaties op 2750ms met forwards. Bij 2.5 iteraties en normal is de animatie afgelopen met opacity 0.5 en een actieve duur van 2500ms. Bij 2 iteraties en alternate is de eindwaarde 0 en de actieve duur 2000ms. Bij 0 iteraties is de aangehouden waarde 0. Met infinite bevindt de animatie zich in de derde cyclus en is de dekking 0.75. De berekende waarden van currentIteration zijn 2, 1, 0 en 2: dit zijn indices vanaf nul, niet de opgegeven CSS-aantallen.

Voorbeelden

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

Resultaat

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

Uitgevoerd in Chromium 157.0.8103.51. De werkelijk berekende waarden worden op een gekozen tijdstip uitgelezen. De test draait geen oneindige lus en controleert geen reeks herhalingsgebeurtenissen. Bied gebruikers een pauzemogelijkheid en houd rekening met hun voorkeur voor minder beweging.

Bronnen