Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Animation: controlar animaciones en el navegador

Animation controla la reproducción de un efecto en una línea de tiempo. Permite iniciar, pausar y recorrer una animación independientemente de la definición de sus fotogramas clave.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

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

Animation controla la reproducción; KeyframeEffect describe los fotogramas clave y los parámetros temporales, mientras que DocumentTimeline proporciona la línea de tiempo. Es una API web, no forma parte de ECMAScript. La presencia de Node.js 24 por sí sola no confirma que esté disponible.

new Animation(effect, timeline) no inicia la reproducción automáticamente; element.animate() crea una animación y la reproduce. Los métodos play(), pause(), reverse() y cancel() controlan la reproducción. En una línea de tiempo del documento, currentTime representa milisegundos y puede ser null.

ready indica que ha terminado una operación de reproducción o pausa pendiente; finished indica que ha terminado la reproducción. Si llamas a cancel() en una animación que aún no ha terminado y no está en estado idle, su promesa finished pendiente se rechaza con un error AbortError. Gestiona el rechazo si utilizas esa promesa. Una animación recién creada en estado idle tiene una promesa finished pendiente, que sigue pendiente si llamas a cancel() mientras la animación está en ese estado.

El ejemplo establece el tiempo sin iniciar la reproducción: la interpolación lineal produce una opacidad de 0.5. Comprueba que las API utilizadas estén disponibles en el navegador de destino.

Ejemplos

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

Resultado

500
0.5

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes