CKTIS / CSS
animation-duration: délka jednoho cyklu
Určete délku jedné iterace časové animace nezávisle na zpoždění a počtu opakování.
Verze: CSS Modules
Syntaxe
animation-duration: 1s, 250ms;animation-duration nastavuje délku jedné iterace, nikoli celkový čas včetně všech opakování nebo počátečního zpoždění. Použijte nezáporný čas s jednotkou s nebo ms; záporný čas a nenulové číslo bez jednotky jsou neplatné. Hodnoty oddělené čárkami odpovídají položkám animation-name; kratší seznam dob se opakuje, aby pokryl názvy. U běžné časové animace dává délka cyklu násobená animation-iteration-count aktivní dobu, zatímco animation-delay je samostatné.
CSS Animations Level 2 definuje auto jako počáteční hodnotu. Na časové ose dokumentu se auto chová jako 0s; výpis vyřešeného stylu podle starších pravidel může uvádět 0s. Nula neznamená nepřítomnost animace: aktivní interval je okamžitý, události začátku a konce mohou stále nastat a animation-fill-mode určuje případný viditelný efekt před ním a po něm. Na ose řízené posouváním auto vyplní příslušný rozsah se zohledněním dalších časových nastavení; aktuální návrh tam zachází s explicitním časem jako s auto. Posouvací animace tím nezíská pevnou délku v sekundách reálného času.
Příklad vytváří pozastavené lineární animace neprůhlednosti a každou odečítá v 500ms. Cyklus 1s dává 0.5 a cyklus 2s hodnotu 0.25. S výplní both a výchozím dopředným směrem už 0s a auto ukazují koncový bod 1; vypočtené délky iterací jsou nulové. Prohlížeč odmítá také -1s a samotnou hodnotu 1. Jde o skutečné odečty stylu a časování, nikoli odpočet nebo tvrzení o snímkové frekvenci.
Příklady
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'));Výsledek
opacity=0.5,0.25,1,1 duration=1000,2000,0,0 negative=false; unitless=false; auto=true
Provedeno v Chromium 157.0.8103.51 na časové ose dokumentu. Příklad ověřuje časovou délku a auto, nikoli posouvací časování nebo doručování událostí. Výklad posouvání vychází z aktuálního návrhu CSS Animations Level 2; tuto funkci ověřte zvlášť v cílových prohlížečích.