Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

animation: una dichiarazione per configurare tutta l’animazione

Combina il nome dei fotogrammi chiave con le impostazioni temporali, considerando valori omessi e ripristini.

Versione: CSS Modules

Sintassi

animation: travel 1s linear 500ms 2 alternate both paused;

La proprietà abbreviata animation descrive una o più animazioni separate da virgole. Ogni voce fornisce un nome e impostazioni per durata, curva temporale, ritardo, ripetizioni, direzione, riempimento e riproduzione. Definisci separatamente i @keyframes richiamati. Il primo tempo è la durata e il secondo il ritardo; una durata negativa non è valida, mentre un ritardo negativo è consentito. Una parola chiave ambigua viene prima assegnata a un’altra impostazione compatibile e solo dopo considerata un nome. Nomi riconoscibili riducono le sorprese.

Le sottoproprietà omesse tornano ai valori iniziali anziché conservare dichiarazioni precedenti. Nel normale caso basato sul tempo, omettere la durata significa zero secondi, quindi nessuna progressione visibile graduale. Le proprietà singole dichiarate dopo possono sovrascrivere l’abbreviazione. I controlli più recenti di linea temporale e intervallo richiedono verifiche di compatibilità specifiche: impostali dopo l’abbreviazione per evitarne il ripristino. L’animazione non è ereditata e le preferenze di movimento ridotto richiedono comunque un’alternativa adeguata.

L’esempio definisce un movimento lineare di un secondo, con ritardo di 500ms, due iterazioni alternate, riempimento su entrambi i lati e stato in pausa. I tempi locali espliciti 0,1000,2000,2500ms producono le coppie opacità/traslazione 0.20/0, 0.50/50, 0.50/50 e 0.20/0. Il ritardo e la seconda iterazione inversa spiegano il punto medio ripetuto e il ritorno finale. Sostituire la dichiarazione con il solo nome riporta a 0s una durata precedente di cinque secondi, oltre a ripristinare i valori iniziali di ritardo, direzione, riempimento e riproduzione.

Esempi

const style=document.createElement('style');
style.textContent='@keyframes travel{from{opacity:.2;transform:translateX(0px)}to{opacity:.8;transform:translateX(100px)}}';document.head.append(style);
const box=document.createElement('div');box.style.animation='travel 1s linear 500ms 2 alternate both paused';document.body.append(box);
const animation=box.getAnimations()[0];
const samples=[0,1000,2000,2500].map(time=>{animation.currentTime=time;const s=getComputedStyle(box);return Number(s.opacity).toFixed(2)+','+new DOMMatrix(s.transform).m41});
const s=getComputedStyle(box);console.log('settings='+[s.animationName,s.animationDuration,s.animationDelay,s.animationIterationCount,s.animationDirection,s.animationPlayState].join('|'));
console.log('samples='+samples.join(' / '));
box.style.animationDuration='5s';box.style.animation='travel';
const reset=getComputedStyle(box);console.log('reset='+[reset.animationDuration,reset.animationDelay,reset.animationDirection,reset.animationFillMode,reset.animationPlayState].join('|'));

Risultato

settings=travel|1s|0.5s|2|alternate|paused
samples=0.20,0 / 0.50,50 / 0.50,50 / 0.20,0
reset=0s|0s|normal|none|running

Il browser valuta veri fotogrammi chiave CSS. Impostare currentTime sulla CSSAnimation rende deterministico il campionamento; non vengono misurati attese, frequenza dei fotogrammi o comportamenti di una linea temporale di scorrimento.

Fonti