Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Animation.play(): avviare e riprendere le animazioni

Animation.play() avvia o riprende un’animazione esistente. Non crea un’altra animazione e non restituisce una promise.

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

animation.play()

animation.play() non accetta argomenti e restituisce undefined. Per un’animazione che usa la linea temporale del documento (document.timeline), come nell’esempio, play() mantiene la posizione corrente se la velocità effettiva di riproduzione è positiva e il tempo corrente non è negativo e precede la fine dell’effetto. A quella velocità, se il tempo corrente raggiunge o supera la fine dell’effetto, play() riporta l’animazione all’inizio, anche se è in pausa.

Dopo una chiamata a updatePlaybackRate(), la velocità effettiva di riproduzione usata da play() può differire da playbackRate: se c’è una modifica della velocità ancora in sospeso, play() usa il valore in sospeso. Sulla linea temporale del documento, un valore negativo in sospeso può quindi far sì che play() passi dal tempo zero alla fine di un effetto di durata finita, anche se playbackRate indica ancora un valore positivo.

L’avvio della riproduzione può attendere un’attività asincrona. animation.ready segnala che l’animazione è pronta, mentre animation.finished ne segnala il completamento. La chiamata a play() non attende né l’uno né l’altro.

Questa è una Web API, non una funzionalità ECMAScript. Verifica il supporto nel browser di destinazione; Node 24 non lo dimostra. L’esempio mostra la ripresa da una posizione all’interno dell’intervallo temporale dell’effetto, non il caso di una velocità negativa in sospeso. Usa un effetto senza elemento di destinazione e non disegna nulla.

Esempi

const effect = new KeyframeEffect(null, [], { duration: 1000 });
const animation = new Animation(effect, document.timeline);

animation.currentTime = 400;
const result = animation.play();
console.log(result === undefined, animation.currentTime);

animation.finish();
console.log(animation.playState, animation.currentTime);

Risultato

true 400
finished 1000

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.

Fonti