Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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         // Element

Entre 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