Atualizar a animação junto à pintura
O requestAnimationFrame() é um método do navegador que agenda uma função para executar no ciclo de renderização que precede a próxima pintura da página. A pintura é a etapa que desenha o conteúdo visual. O agendamento oferece uma oportunidade de atualizar a animação em sintonia com esse trabalho.
A função recebe um timestamp, uma referência temporal em milissegundos. Você pode subtrair o tempo registrado na primeira execução do tempo atual para calcular quanto a animação já avançou. Cada chamada agenda uma única execução, por isso o código solicita outra quando ainda há movimento a realizar.
Um deslocamento calculado pelo tempo
O exemplo move um elemento identificado por marcador até 240 pixels para a direita ao longo de 800 milissegundos. Execute o código depois que esse elemento existir na página:
const marcador = document.getElementById("marcador")let inicio
function animar(tempo) { inicio ??= tempo const progresso = Math.min((tempo - inicio) / 800, 1) marcador.style.transform = `translateX(${240 * progresso}px)`
if (progresso < 1) { requestAnimationFrame(animar) }}
requestAnimationFrame(animar)Na primeira execução, o progresso vale zero. Depois de 400 milissegundos, o cálculo corresponde à metade do percurso, ou 120 pixels. Quando o tempo decorrido alcança 800 milissegundos, o valor fica limitado a um e o código deixa de solicitar atualizações. A posição depende do tempo, o que evita aumentar o deslocamento só porque a tela apresenta mais quadros por segundo.
Pausas e intervalo entre chamadas
O navegador costuma suspender essas chamadas em abas em segundo plano. Ao voltar à página, o tempo decorrido pode fazer o exemplo saltar até o fim do percurso. Para uma animação que deva pausar junto com a aba, você precisa tratar essa interrupção e ajustar a referência temporal.
O método também não promete execução pontual a cada intervalo. Uma função de atualização demorada ocupa o tempo disponível para preparar os quadros, por isso você ainda precisa conferir a fluidez na página.
Dúvidas frequentes
Perguntas frequentes sobre requestAnimationFrame
- Uma chamada mantém a animação em execução?
- Cada chamada solicita uma execução da função. Para continuar, o código precisa chamar requestAnimationFrame novamente, normalmente dentro da própria função de atualização.
- A função é executada sessenta vezes por segundo?
- A frequência geralmente acompanha a atualização da tela, que pode ser maior ou menor. O método não promete um intervalo fixo e costuma pausar as chamadas em abas em segundo plano.
- Como cancelar uma atualização pendente?
- Guarde o identificador retornado por requestAnimationFrame e passe esse valor a cancelAnimationFrame. Num ciclo de animação, atualize o identificador a cada nova solicitação.
Para continuar
Recursos relacionados
Documentação
MDN: agendamento por requestAnimationFrame
Referência do agendamento, do tempo recebido pela função e do identificador usado para cancelar uma atualização pendente.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão de desenvolvimento colaborativo para investigar animações e revisar seu código com orientação técnica ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão de uma animação criada com agentes inclui conferir o cálculo do movimento e o comportamento da página quando a aba fica em segundo plano.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.