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

CKTIS / JavaScript

IntersectionObserverEntry — leer la intersección de un elemento

IntersectionObserverEntry describe la intersección de un elemento observado con su raíz en un instante registrado. Sus propiedades isIntersecting, target e intersectionRatio permiten conocer el estado de intersección, identificar el elemento y leer la fracción de su área que se intersecta.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

entry.isIntersecting
entry.target
entry.intersectionRatio

IntersectionObserverEntry es una instantánea de geometría, no un objeto que se actualice continuamente. El navegador entrega las entradas de forma asíncrona a una función de retorno de llamada de IntersectionObserver; también se pueden obtener las entradas pendientes mediante takeRecords(). La función de retorno de llamada debe procesar toda la matriz entries, no solo la primera entrada.

IntersectionObserverEntry.target hace referencia al Element observado. IntersectionObserverEntry.isIntersecting es un booleano que indica si hay intersección con la raíz. IntersectionObserverEntry.intersectionRatio es un número entre 0 y 1: el área de intersectionRect dividida por el área de boundingClientRect. Para un objetivo con área cero, vale 1 cuando isIntersecting es true y 0 en caso contrario; no trates estas dos propiedades como equivalentes.

La primera notificación describe el estado inicial después de observe(). Las notificaciones posteriores dependen, entre otras cosas, de que se crucen los valores threshold configurados; no informan de cada píxel desplazado al hacer scroll. Para reaccionar cuando se intersecte la mitad del área, incluye el umbral 0.5 y comprueba entry.isIntersecting && entry.intersectionRatio >= 0.5. La observación geométrica habitual no demuestra que otro elemento no esté cubriendo el objetivo.

Esta es una API Web del navegador, no una característica de una edición concreta de ECMAScript. MDN indica que la interfaz básica está ampliamente disponible desde marzo de 2019; las funciones adicionales pueden tener otro nivel de compatibilidad. Que Node 24 esté presente en un repositorio no demuestra que la API esté disponible. El ejemplo coloca un objetivo de 100px de alto dentro de una raíz de recorte de 50px de alto y, después, detiene la observación.

Ejemplos

(() => {
  const root = document.createElement('div');
  root.style.cssText = 'all:initial;position:fixed;top:0;left:0;width:100px;height:50px;overflow:hidden;';
  const target = document.createElement('div');
  target.style.cssText = 'all:initial;display:block;width:100px;height:100px;';
  root.append(target);
  document.body.append(root);

  const observer = new IntersectionObserver((entries) => {
    for (const entry of entries) {
      console.log(
        entry.isIntersecting,
        entry.target === target,
        entry.intersectionRatio.toFixed(2)
      );
    }
    observer.disconnect();
    root.remove();
  }, { root, threshold: [0, 0.5, 1] });

  observer.observe(target);
})();

Resultado

true true 0.50

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes