CKTIS / JavaScript
Animation — controlar animações no navegador
Animation controla a reprodução de um efeito numa linha temporal. Permite iniciar, colocar em pausa e percorrer uma animação independentemente da definição dos respetivos fotogramas-chave.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new Animation(effect, timeline)
const animation = element.animate(keyframes, options);Animation controla a reprodução; KeyframeEffect descreve os fotogramas-chave e os parâmetros temporais, enquanto DocumentTimeline fornece a linha temporal. É uma API Web, não faz parte do ECMAScript. A presença de Node.js 24, por si só, não confirma a disponibilidade desta API.
new Animation(effect, timeline) não inicia automaticamente a reprodução; element.animate() cria uma animação e reprodu-la. Os métodos play(), pause(), reverse() e cancel() controlam a reprodução. Numa linha temporal do documento, currentTime representa milissegundos e pode ser null.
ready assinala a conclusão de uma operação de reprodução ou pausa pendente; finished assinala o fim da reprodução. Se chamares cancel() numa animação que ainda não terminou e não está no estado idle, a sua promessa finished pendente é rejeitada com um erro AbortError. Trata a rejeição se utilizares esta promessa. Uma animação acabada de criar no estado idle tem uma promessa finished pendente, que continua pendente se chamares cancel() enquanto a animação está nesse estado.
O exemplo define o tempo sem iniciar a reprodução: a interpolação linear produz uma opacidade de 0.5. Verifica a disponibilidade das APIs utilizadas no navegador de destino.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.