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
Documentação
MDN: observação assíncrona de interseções
Explica a raiz de observação, os limiares de interseção e as informações recebidas pela função de retorno.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Orientação técnica ao vivo para revisar o código de uma interface e investigar quando o observador executa suas ações.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.