Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

IntersectionObserverEntry: estado de intersección y elemento observado

`isIntersecting` indica si el elemento intersecta la zona de referencia en el momento de la medición, mientras que `target` identifica el elemento observado al que corresponde la entrada.

Versión: Current web platform; runtime support varies

Sintaxis

entry.isIntersecting // boolean
entry.target         // Element

Entre las propiedades de instancia de solo lectura de IntersectionObserverEntry están entry.isIntersecting y entry.target. entry.isIntersecting es un booleano (true si el elemento intersecta la zona de referencia, false en caso contrario). entry.target es el mismo objeto DOM de tipo Element que se pasó a observe(), no la raíz ni un selector. La zona de referencia puede ser, por ejemplo, un contenedor desplazable. Cuando root es null (el valor predeterminado), la zona de referencia es el área de visualización (viewport) del documento de nivel superior. Si el elemento está dentro de un iframe, al calcular intersectionRect también se aplica el recorte a los límites del área de visualización del marco.

Una entrada registra una medición y no se actualiza en tiempo real. Después de observe(), el informe inicial llega de forma asíncrona aunque el elemento no se haya movido. Las entradas posteriores pueden notificar un cambio en el estado de intersección o el cruce de un umbral configurado para la proporción de intersección. Por eso, true por sí solo no significa que el elemento acabe de entrar. Procesa todo el array entries: una llamada a la función de retorno puede entregar varias entradas.

El contacto entre bordes puede contar como intersección aunque intersectionRatio sea 0. Para comprobar que el área de intersección geométrica es positiva, exige que se cumplan tanto entry.intersectionRect.width > 0 como entry.intersectionRect.height > 0. Eso no demuestra que el usuario pueda ver el elemento: otro elemento podría taparlo.

Esta API pertenece a la plataforma web, no a ECMAScript 2024. Comprueba que el entorno de destino proporciona IntersectionObserver. Usa unobserve(element) para dejar de observar un elemento o disconnect() para dejar de observar todos los elementos de ese observador.

Ejemplos

<!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 el código como archivo HTML, ábrelo en un navegador y consulta el resultado en la consola de desarrollo. El primer elemento está dentro del contenedor de referencia y el segundo está completamente fuera. El código espera ambas entradas iniciales, muestra los estados en un orden fijo y limpia los recursos utilizados.

Lecciones relacionadas

  • JavaScript · Lección 30 · Intermedio · Versión: 3

Fuentes