CKTIS / CSS
animation-duration: la durata di un ciclo
Imposta il tempo di una singola iterazione di un’animazione temporale, indipendentemente da ritardo e ripetizioni.
Versione: CSS Modules
Sintassi
animation-duration: 1s, 250ms;animation-duration stabilisce la durata di un’iterazione, non il tempo totale di tutte le ripetizioni o del ritardo iniziale. Usa un tempo non negativo con s o ms; un tempo negativo o un numero non nullo senza unità non è valido. I valori separati da virgole corrispondono alle voci di animation-name; un elenco di durate più corto si ripete fino a coprire i nomi. Per una normale animazione temporale, la durata moltiplicata per animation-iteration-count dà la durata attiva, mentre animation-delay è separato.
CSS Animations Level 2 definisce auto come valore iniziale. Sulla linea temporale del documento, auto si comporta come 0s; la restituzione dello stile risolto compatibile con le regole precedenti può mostrare 0s. Zero non significa assenza dell’animazione: il suo intervallo attivo è istantaneo, gli eventi iniziale e finale possono comunque verificarsi e animation-fill-mode determina eventuali effetti visibili prima o dopo. Su una linea temporale guidata dallo scorrimento, auto riempie invece l’intervallo pertinente tenendo conto degli altri parametri temporali; la bozza attuale tratta lì anche un tempo esplicito come auto. Ciò non fa durare un’animazione legata allo scorrimento un numero fisso di secondi reali.
L’esempio crea animazioni lineari dell’opacità in pausa e le legge a 500ms. Un ciclo di 1s produce 0.5 e uno di 2s produce 0.25. Con riempimento both e direzione normale predefinita, 0s e auto mostrano già il valore finale 1; le loro durate calcolate di iterazione sono zero. Il browser rifiuta anche -1s e il valore 1 senza unità. Sono letture reali di stile calcolato e parametri temporali, non un conto alla rovescia né una dichiarazione sulla frequenza dei fotogrammi.
Esempi
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'));Risultato
opacity=0.5,0.25,1,1 duration=1000,2000,0,0 negative=false; unitless=false; auto=true
Eseguito in Chromium 157.0.8103.51 sulla linea temporale del documento. L’esempio verifica la durata temporale e auto, non i tempi guidati dallo scorrimento o la consegna degli eventi. La spiegazione dello scorrimento segue la bozza attuale CSS Animations Level 2; prova quella funzione separatamente nei browser di destinazione.