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

CKTIS / CSS

animation-play-state: pausar y continuar la misma animación

Detén el progreso de la animación y reanúdalo sin perder la posición actual.

Versión: CSS Modules

Sintaxis

animation-play-state: paused;

animation-play-state acepta running o paused, con running como valor inicial. Pausar detiene el reloj de la animación y mantiene visible su efecto actual. Volver a running continúa desde esa posición en vez de empezar de nuevo. La pausa también congela un animation-delay que aún no haya terminado. Con varias entradas de animation-name, los estados separados por comas controlan cada animación; una lista más corta se repite.

Pausar no es cancelar, quitar el nombre de la animación ni restablecer el estilo subyacente. No pausa transiciones independientes, vídeos ni trabajo JavaScript. Una animación terminada no se convierte automáticamente en un nuevo ciclo solo por declarar running otra vez. El control explícito de reproducción/pausa mediante Web Animations API también puede prevalecer sobre el control CSS correspondiente según sus reglas específicas; deja claro quién controla la animación en vez de mezclar dos mecanismos accidentalmente.

El ejemplo inicia una animación CSS pausada, fija su posición en 250ms y lee opacidad 0.25. Dos fotogramas de animación después, el tiempo no ha cambiado. Cambiar la propiedad CSS a running hace avanzar el mismo objeto de animación más allá de esa posición; volver a paused mantiene el nuevo tiempo durante otros dos fotogramas. Una animación aparte con retardo de 1s permanece en 400ms de ese retardo mientras está pausada, dejando la opacidad subyacente en 0.7. Las comprobaciones de avance impresas son booleanos, no intervalos fijos de fotograma inventados.

Ejemplos

const style=document.createElement('style');style.textContent='@keyframes play-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const frame=()=>new Promise(resolve=>requestAnimationFrame(resolve));
const el=document.createElement('div');el.style.cssText='opacity:0.7;animation-name:play-demo;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';document.body.append(el);
const animation=el.getAnimations()[0];await animation.ready;animation.currentTime=250;const held=animation.currentTime,opacity=getComputedStyle(el).opacity;
await frame();await frame();const stable=animation.currentTime===held;
el.style.animationPlayState='running';getComputedStyle(el).animationPlayState;await animation.ready;await frame();await frame();
const advanced=animation.currentTime>held,same=el.getAnimations()[0]===animation;
el.style.animationPlayState='paused';getComputedStyle(el).animationPlayState;await animation.ready;const stopped=animation.currentTime;await frame();await frame();
const delayed=document.createElement('div');delayed.style.cssText='opacity:0.7;animation:play-demo 1s linear 1s paused';document.body.append(delayed);
const waiting=delayed.getAnimations()[0];await waiting.ready;waiting.currentTime=400;await frame();await frame();
console.log('held='+held+'; opacity='+opacity+'; stable='+stable);
console.log('resumed='+advanced+'; same-animation='+same+'; paused-again='+(animation.currentTime===stopped)+'; state='+animation.playState);
console.log('delay-held='+(waiting.currentTime===400)+'; delay-opacity='+getComputedStyle(delayed).opacity);

Resultado

held=250; opacity=0.25; stable=true
resumed=true; same-animation=true; paused-again=true; state=paused
delay-held=true; delay-opacity=0.7

Ejecutado en Chromium 157.0.8103.51 con callbacks reales de fotogramas de animación. El código cambia el estado mediante CSS; currentTime solo establece las posiciones de medida. Verifica pausa/reanudación y un retardo pausado, no la planificación de pestañas en segundo plano, el reinicio de animaciones terminadas ni los casos de prioridad de la API.

Fuentes