Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é IntersectionObserver?

    O IntersectionObserver avisa quando um elemento cruza limites de interseção com uma área de referência, permitindo reagir à sua posição durante a rolagem.

    Também chamado de: Intersection Observer API

    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

    Quando parte do elemento entra na área observada

    O IntersectionObserver é uma interface do navegador que notifica o JavaScript sobre mudanças na interseção entre um elemento e uma área de referência. A interseção é a parte da área do elemento que coincide com a região observada. Essa referência, chamada raiz, pode ser a área visível do documento ou um elemento ancestral.

    Você escolhe os elementos observados e os limiares que devem gerar notificações. Um limiar de 0.5 corresponde à metade da área do elemento. O navegador calcula as interseções e entrega os registros de forma assíncrona, por uma função de retorno. O código recebe essas notificações depois do cálculo, em vez de medir a posição a cada evento de rolagem.

    Registrar a passagem pela metade da área

    Neste exemplo, a página já contém um elemento com o identificador aviso. O código acompanha sua interseção com a área visível do documento:

    const alvo = document.querySelector('#aviso');
    if (alvo) {
    const observador = new IntersectionObserver((registros) => {
    for (const registro of registros) {
    if (registro.isIntersecting && registro.intersectionRatio >= 0.5) {
    console.log('Pelo menos metade da área entrou na região observada.');
    }
    }
    }, { root: null, threshold: 0.5 });
    observador.observe(alvo);
    }

    O teste de alvo evita iniciar a observação quando o elemento não existe. O método observe registra o elemento. A função recebe uma notificação inicial e outras conforme os limites são cruzados. A propriedade intersectionRatio informa a proporção da área que está em interseção.

    A mensagem aparece no console quando o registro indica uma interseção de pelo menos metade da área. O código pode exibi-la novamente após o elemento sair e retornar. Para executar uma ação uma única vez, você pode encerrar a observação daquele elemento com unobserve depois da ação.

    O alcance da medição geométrica

    A opção rootMargin amplia ou reduz a região considerada no cálculo. Uma margem positiva pode permitir a preparação de um recurso antes de ele aparecer na tela, embora o observador apenas sinalize a condição. O carregamento precisa ser implementado pela aplicação.

    Na configuração padrão, uma interseção pode ser registrada mesmo com outro elemento cobrindo o conteúdo. Por isso, o exemplo descreve a posição do aviso e não demonstra que você o viu ou leu.

    Dúvidas frequentes

    Perguntas frequentes sobre IntersectionObserver

    A referência precisa ser a janela do navegador?
    Com root definido como null, a referência é a área visível do documento. Você também pode configurar um elemento ancestral como raiz para observar a interseção dentro dele.
    O observador é chamado a cada pixel de rolagem?
    As notificações seguem mudanças nos limiares configurados e no estado de interseção. Há também uma notificação inicial após o início da observação. A API não oferece um retorno por pixel percorrido.
    Uma interseção comprova que o conteúdo foi lido?
    A medição descreve a geometria do elemento em relação à raiz. Ela não comprova atenção, leitura ou compreensão. Na configuração padrão, também não verifica se outro elemento está cobrindo o conteúdo.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    A implementação de interfaces exige compreender quando o navegador sinaliza a presença de um elemento na área observada.

    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