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.