Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Animation — contrôler les animations dans le navigateur

Animation contrôle la lecture d’un effet sur une chronologie. Elle permet de démarrer, de mettre en pause et de parcourir une animation indépendamment de la définition de ses images clés.

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

new Animation(effect, timeline)
const animation = element.animate(keyframes, options);

Animation contrôle la lecture ; KeyframeEffect décrit les images clés et les paramètres temporels, tandis que DocumentTimeline fournit la chronologie. Il s’agit d’une API Web, et non d’une partie d’ECMAScript. La présence de Node.js 24 à elle seule ne garantit pas que cette API soit disponible.

new Animation(effect, timeline) ne démarre pas automatiquement la lecture ; element.animate() crée une animation et la lance. Les méthodes play(), pause(), reverse() et cancel() contrôlent la lecture. Sur une chronologie de document, currentTime représente des millisecondes et peut valoir null.

ready signale la fin d’une opération de lecture ou de pause en attente ; finished signale la fin de la lecture. Appeler cancel() sur une animation qui n’est ni terminée ni dans l’état idle rejette sa promesse finished en attente avec une erreur AbortError. Gérez ce rejet si vous utilisez cette promesse. Pour une animation nouvellement créée dans l’état idle, la promesse finished est en attente et le reste si vous appelez cancel() alors que l’animation est dans cet état.

L’exemple définit le temps sans démarrer la lecture : l’interpolation linéaire produit une opacité de 0.5. Vérifiez que les API utilisées sont disponibles dans le navigateur cible.

Exemples

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();

Résultat

500
0.5

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.

Sources