CKTIS / JavaScript
Animation — controllare le animazioni nel browser
Animation controlla la riproduzione di un effetto su una timeline. Permette di avviare, mettere in pausa e scorrere un’animazione indipendentemente dalla definizione dei suoi fotogrammi chiave.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new Animation(effect, timeline)
const animation = element.animate(keyframes, options);Animation controlla la riproduzione; KeyframeEffect descrive i fotogrammi chiave e i parametri temporali, mentre DocumentTimeline fornisce la timeline. È una Web API, non fa parte di ECMAScript. La sola presenza di Node.js 24 non conferma che sia disponibile.
new Animation(effect, timeline) non avvia automaticamente la riproduzione; element.animate() crea un’animazione e la riproduce. I metodi play(), pause(), reverse() e cancel() controllano la riproduzione. Su una timeline del documento, currentTime rappresenta millisecondi e può essere null.
ready segnala il completamento di un’operazione di riproduzione o pausa in sospeso; finished segnala il completamento della riproduzione. Se chiami cancel() su un’animazione che non è ancora terminata e non è nello stato idle, la sua promise finished in sospeso viene rifiutata con un errore AbortError. Gestisci il rifiuto se usi questa promise. Un’animazione appena creata nello stato idle ha una promise finished in sospeso, che rimane tale se chiami cancel() mentre l’animazione è in quello stato.
L’esempio imposta il tempo senza avviare la riproduzione: l’interpolazione lineare produce un’opacità di 0.5. Verifica la disponibilità delle API usate nel browser di destinazione.
Esempi
const box = document.createElement('div');
box.textContent = 'Animation';
document.body.append(box);
const effect = new KeyframeEffect(
box,
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, easing: 'linear', fill: 'both' }
);
const animation = new Animation(effect, document.timeline);
animation.currentTime = 500;
console.log(animation.currentTime);
console.log(getComputedStyle(box).opacity);
animation.cancel();
box.remove();Risultato
500 0.5
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.