CKTIS / JavaScript
Element.animate — fotogramas-chave e temporização da animação
Crie animações com Element.animate, definindo fotogramas-chave e opções de temporização; em seguida, controle o objeto Animation devolvido.
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
const animation = element.animate(keyframes, options);Element.animate cria e inicia uma animação, devolvendo um objeto Animation. É uma API Web Animations do navegador, não faz parte do ECMAScript; o Node 24 não demonstra que esteja disponível. Verifique typeof Element.prototype.animate === 'function' no navegador de destino.
Fotogramas-chave e opções de temporização da WAAPI: keyframes aceita um array de objetos ou um objeto que contenha arrays de valores de propriedades. offset indica uma posição entre 0 e 1. options pode ser um valor em milissegundos ou um objeto com duration, delay, iterations, easing, direction e fill. O valor predefinido de duration é auto: na linha temporal predefinida, baseada no tempo, resulta numa duração de zero, mas numa linha temporal controlada pelo deslocamento pode resultar numa duração diferente. fill não altera permanentemente os estilos inline.
O exemplo utiliza pause() e currentTime para observar o ponto intermédio sem esperar. cancel() remove o efeito.
Exemplos
const box = document.createElement('div');
box.textContent = 'WAAPI';
document.body.append(box);
const animation = box.animate(
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, easing: 'linear', fill: 'both' }
);
animation.pause();
animation.currentTime = 500;
console.log(getComputedStyle(box).opacity);
animation.cancel();
box.remove();Resultado
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.