CKTIS / JavaScript
Animation.play() : démarrer et reprendre des animations
Animation.play() démarre ou reprend une animation existante. Cette méthode ne crée pas une autre animation et ne renvoie pas de promesse.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
animation.play()animation.play() ne prend aucun argument et renvoie undefined. Pour une animation qui utilise la chronologie du document (document.timeline), comme dans l’exemple, play() conserve la position actuelle si la vitesse de lecture effective est positive et si le temps courant est positif ou nul et précède la fin de l’effet. À cette vitesse, si le temps courant atteint ou dépasse la fin de l’effet, play() ramène l’animation au début, même si elle est en pause.
Après un appel à updatePlaybackRate(), la vitesse de lecture effective utilisée par play() peut différer de playbackRate : si un changement de vitesse est en attente, play() utilise la valeur en attente. Sur la chronologie du document, une valeur négative en attente peut donc amener play() à faire passer le temps courant de zéro à la fin d’un effet de durée finie, alors même que playbackRate indique encore une valeur positive.
Le démarrage de la lecture peut attendre une tâche asynchrone. animation.ready signale que l’animation est prête, tandis que animation.finished signale qu’elle est terminée. L’appel de play() lui-même n’attend ni l’un ni l’autre.
Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript. Vérifiez sa prise en charge dans le navigateur cible ; Node 24 ne permet pas de l’établir. L’exemple montre une reprise à partir d’une position comprise dans la plage temporelle de l’effet, et non le cas d’une vitesse négative en attente. Il utilise un effet sans élément cible et n’affiche rien.
Exemples
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);Résultat
true 400 finished 1000
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.