CKTIS / CSS
animation-duration: dĺžka jedného cyklu
Určte čas jednej iterácie časovej animácie nezávisle od oneskorenia a počtu opakovaní.
Verzia: CSS Modules
Syntax
animation-duration: 1s, 250ms;animation-duration nastavuje dĺžku jednej iterácie, nie celkový čas vrátane všetkých opakovaní alebo počiatočného oneskorenia. Použite nezáporný čas s jednotkou s alebo ms; záporný čas a nenulové číslo bez jednotky sú neplatné. Hodnoty oddelené čiarkami zodpovedajú položkám animation-name; kratší zoznam dôb sa opakuje, aby pokryl názvy. Pri bežnej časovej animácii dáva dĺžka cyklu násobená animation-iteration-count aktívnu dobu, kým animation-delay je samostatné.
CSS Animations Level 2 definuje auto ako počiatočnú hodnotu. Na časovej osi dokumentu sa auto správa ako 0s; výpis vyriešeného štýlu podľa starších pravidiel môže uvádzať 0s. Nula neznamená neprítomnosť animácie: aktívny interval je okamžitý, udalosti začiatku a konca môžu stále nastať a animation-fill-mode určuje prípadný viditeľný efekt pred ním a po ňom. Na osi riadenej posúvaním auto vyplní príslušný rozsah so zohľadnením ostatných časových nastavení; aktuálny návrh tam považuje explicitný čas za auto. Posúvacia animácia tým nezíska pevnú dĺžku v sekundách reálneho času.
Príklad vytvára pozastavené lineárne animácie nepriehľadnosti a každú odčíta v 500ms. Cyklus 1s dáva 0.5 a cyklus 2s hodnotu 0.25. S výplňou both a predvoleným smerom dopredu už 0s a auto ukazujú koncový bod 1; vypočítané dĺžky iterácií sú nulové. Prehliadač odmieta aj -1s a samotnú hodnotu 1. Ide o skutočné odčítania štýlu a časovania, nie odpočítavanie alebo tvrdenie o snímkovej frekvencii.
Prí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ýsledok
opacity=0.5,0.25,1,1 duration=1000,2000,0,0 negative=false; unitless=false; auto=true
Vykonané v Chromium 157.0.8103.51 na časovej osi dokumentu. Príklad overuje časovú dĺžku a auto, nie časovanie riadené posúvaním ani doručovanie udalostí. Vysvetlenie posúvania vychádza z aktuálneho návrhu CSS Animations Level 2; túto funkciu overte osobitne v cieľových prehliadačoch.