CKTIS / CSS
animation-duration: de duur van één cyclus
Bepaalt de duur van één iteratie, niet de vertraging of het totale aantal herhalingen.
Versie: CSS Modules
Syntax
animation-duration: 1s, 250ms;animation-duration bepaalt hoe lang één cyclus van een CSS-animatie duurt. Een expliciete tijd gebruikt s of ms en mag niet negatief zijn; een negatief getal en een niet-nul getal zonder eenheid zijn ongeldig. Een lijst met komma’s hoort bij de namen in animation-name. Is de lijst met duren korter, dan worden de waarden herhaald. Op een gewone tijdlijn is de actieve duur bij een eindig aantal iteraties doorgaans de duur maal het aantal iteraties; animation-delay staat daar los van.
In CSS Animations Level 2 is auto de beginwaarde. Op een documenttijdlijn komt auto overeen met 0s; om oudere code te ondersteunen kan CSSOM deze waarde als 0s teruggeven. Een duur van nul betekent niet dat er geen animatie bestaat: deze verloopt ogenblikkelijk, kan start- en eindgebeurtenissen veroorzaken en kan via animation-fill-mode een effect buiten de actieve fase hebben. Op een scrolltijdlijn gebruikt auto het toepasselijke bereik, rekening houdend met de overige tijdinstellingen. In het huidige ontwerp wordt ook een expliciete tijdsduur op zo’n tijdlijn als auto behandeld; lees die dus niet als een vast aantal seconden wandkloktijd.
Het voorbeeld pauzeert een lineaire animatie van opacity en onderzoekt deze op 500ms. Bij een duur van 1s is de dekking 0.5; bij 2s is die 0.25. Met both, de standaardrichting normal en een duur van 0s of auto is de eindwaarde 1 zichtbaar en geeft de berekende timing een duur van 0 terug. -1s en het getal 1 zonder eenheid worden geweigerd. De resultaten komen uit de werkelijk berekende stijl en timing, niet uit een aftelling of een aangenomen beeldsnelheid.
Voorbeelden
const style=document.createElement('style');
style.textContent='@keyframes duration-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const make=duration=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:duration-demo;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';el.style.animationDuration=duration;document.body.append(el);const animation=el.getAnimations()[0];animation.currentTime=500;return {el,animation}};
const rows=['1s','2s','0s','auto'].map(make);
console.log('opacity='+rows.map(({el})=>getComputedStyle(el).opacity).join(','));
console.log('duration='+rows.map(({animation})=>animation.effect.getComputedTiming().duration).join(','));
console.log('negative='+CSS.supports('animation-duration','-1s')+'; unitless='+CSS.supports('animation-duration','1')+'; auto='+CSS.supports('animation-duration','auto'));Resultaat
opacity=0.5,0.25,1,1 duration=1000,2000,0,0 negative=false; unitless=false; auto=true
Uitgevoerd in Chromium 157.0.8103.51 op een documenttijdlijn. Het voorbeeld controleert de duur en auto, maar test geen scrolltijdlijn of bezorging van gebeurtenissen. Het beschreven scrollgedrag komt uit het huidige specificatieontwerp en moet in de doelbrowser worden gecontroleerd.