Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti