Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

animation-play-state: pausar e continuar a mesma animação

Suspende o progresso da animação e retoma-o sem perder a posição atual.

Versão: CSS Modules

Sintaxe

animation-play-state: paused;

animation-play-state aceita running ou paused, sendo running o valor inicial. Pausar para o relógio da animação e mantém visível o efeito atual. Voltar a running continua a partir dessa posição em vez de recomeçar. A pausa também suspende um animation-delay ainda não concluído. Com várias entradas de animation-name, os estados separados por vírgulas controlam cada animação; uma lista mais curta repete-se.

Pausar não é cancelar, remover o nome da animação ou repor o estilo subjacente. Não pausa transições independentes, vídeos nem trabalho JavaScript. Uma animação terminada não se torna automaticamente um novo ciclo apenas por declarar running novamente. O controlo explícito de reprodução/pausa pela Web Animations API também pode sobrepor-se ao controlo CSS correspondente segundo regras próprias; define claramente quem controla a animação em vez de misturar dois mecanismos por acidente.

O exemplo inicia uma animação CSS em pausa, fixa a posição nos 250ms e lê opacidade 0.25. Dois fotogramas de animação depois, o tempo não mudou. Alterar a propriedade CSS para running faz avançar o mesmo objeto de animação para além dessa posição; regressar a paused mantém o novo tempo durante mais dois fotogramas. Outra animação com atraso de 1s fica nos 400ms desse atraso enquanto está em pausa, deixando a opacidade subjacente em 0.7. As verificações de avanço apresentadas são booleanos, não intervalos fixos de fotogramas inventados.

Exemplos

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

Executado no Chromium 157.0.8103.51 com callbacks reais de fotogramas de animação. O código altera o estado por CSS; currentTime serve apenas para estabelecer as posições de medição. Verifica pausa/retoma e atraso suspenso, não o escalonamento de separadores em segundo plano, o reinício de animações terminadas nem os casos de sobreposição pela API.

Fontes