CKTIS / JavaScript
IntersectionObserver: observar intersecciones de elementos
IntersectionObserver informa de forma asíncrona de la intersección geométrica entre un elemento y una región de referencia. Aprende las opciones root, rootMargin y threshold, y distingue la intersección de la visibilidad real.
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
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })IntersectionObserver es una API web del navegador, no una característica de ECMAScript. Que esté disponible en Node 24 no demuestra que el navegador la admita; compruébalo en el entorno de destino.
root define la región de referencia; el valor predeterminado null representa la ventana gráfica. rootMargin amplía o reduce sus límites mediante 1–4 valores en píxeles o porcentajes. Estos desplazamientos solo se aplican a elementos objetivo del mismo dominio de origen (same-origin-domain) y se ignoran para los de un dominio de origen distinto (cross-origin-domain). threshold acepta un número o una matriz dentro de [0, 1], y su valor predeterminado es 0. La propiedad de solo lectura thresholds expone los cocientes del área del objetivo ordenados.
Una vez iniciada la observación, la función callback suele recibir una entrada inicial para el objetivo, pero la entrega no está garantizada. La observación puede detenerse antes de que se genere la entrada, y takeRecords() puede retirarla de la cola antes de que llegue a la función callback. Las entradas posteriores se añaden a la cola cuando se cruza un umbral o cambia isIntersecting. La intersección geométrica no demuestra que haya visibilidad real; los bordes en contacto pueden producir isIntersecting === true con un área de intersección de cero.
observe(target) inicia la observación, unobserve(target) la detiene para un objetivo y disconnect() la detiene para todos. El ejemplo comprueba la intersección completa inicial y limpia los recursos.
Ejemplos
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver unavailable");
}
const root = document.createElement("div");
root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
const target = document.createElement("div");
target.style.cssText = "width:20px;height:20px;margin:0;";
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
console.log(entries[0].intersectionRatio === 1);
observer.disconnect();
root.remove();
}, { root, rootMargin: "0px", threshold: [0, 1] });
observer.observe(target);
})();Resultado
true
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.