Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é requestAnimationFrame?

    O requestAnimationFrame agenda uma função para a próxima atualização visual do navegador. O tempo recebido orienta o progresso de animações e movimentos.

    Também chamado de: requestAnimationFrame()

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano