CKTIS / JavaScript
IntersectionObserverEntry: estado de interseção e elemento observado
`isIntersecting` indica se o elemento intersecta a área de referência no momento da medição, enquanto `target` identifica o elemento observado a que o registo se refere.
Versão: Current web platform; runtime support varies
Sintaxe
entry.isIntersecting // boolean
entry.target // ElementEntre as propriedades de instância só de leitura de IntersectionObserverEntry estão entry.isIntersecting e entry.target. entry.isIntersecting é um booleano (true se o elemento intersectar a área de referência, false caso contrário). entry.target é o mesmo objeto DOM do tipo Element passado a observe(), não a raiz nem um seletor. A área de referência pode ser, por exemplo, um contentor com deslocamento. Quando root tem o valor predefinido null, a área de referência é a área de visualização (viewport) do documento de nível superior. Para um elemento dentro de um iframe, o cálculo de intersectionRect também aplica o recorte aos limites da área de visualização da moldura.
Um registo guarda uma medição e não é atualizado em tempo real. Após observe(), a primeira notificação chega de forma assíncrona, mesmo que o elemento não se tenha movido. Os registos posteriores podem assinalar uma alteração do estado de interseção ou a passagem por um limiar configurado para a proporção de interseção. Assim, true por si só não significa que o elemento acabou de entrar. Processa todo o array entries: uma única chamada da função de callback pode entregar vários registos.
O contacto entre extremidades pode contar como interseção, mesmo que intersectionRatio seja 0. Para verificar se a interseção geométrica tem área positiva, confirma que se verificam entry.intersectionRect.width > 0 e entry.intersectionRect.height > 0. Isso não prova que o utilizador veja o elemento: outro elemento pode tapá-lo.
Esta API pertence à plataforma Web, não a ECMAScript 2024. Confirma se o ambiente de execução disponibiliza IntersectionObserver. Usa unobserve(element) para deixar de observar um elemento ou disconnect() para deixar de observar todos os elementos desse observador.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IntersectionObserverEntry example</title>
</head>
<body>
<script>
(() => {
const root = document.createElement('div');
root.style.cssText = 'position:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';
const makeTarget = (left) => {
const element = document.createElement('div');
element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
root.append(element);
return element;
};
const inside = makeTarget(8);
const outside = makeTarget(150);
document.body.append(root);
const states = new Map();
const observer = new IntersectionObserver((entries, currentObserver) => {
for (const entry of entries) {
states.set(entry.target, entry.isIntersecting);
}
if (!states.has(inside) || !states.has(outside)) return;
currentObserver.disconnect();
root.remove();
console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
}, { root });
observer.observe(inside);
observer.observe(outside);
})();
</script>
</body>
</html>Resultado
inside: true outside: false
Guarda o código como ficheiro HTML, abre-o num navegador e verifica o resultado na consola de desenvolvimento. O primeiro elemento está dentro do contentor de referência e o segundo está completamente fora. O código espera pelos dois registos iniciais, apresenta os estados numa ordem fixa e limpa os recursos utilizados.
Lições relacionadas
- JavaScript · Lição 30 · Intermédio · Versão: 3
Fontes
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserverEntry: target property
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserver: observe() method
- IntersectionObserver: IntersectionObserver() constructor
- Intersection Observer API
- HTML Standard — Event loops
- ECMAScript® 2024 Language Specification — Scope
- Intersection Observer specification