Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

IntersectionObserver: osservare le intersezioni degli elementi

IntersectionObserver segnala in modo asincrono l’intersezione geometrica tra un elemento e una regione di riferimento. Scopri le opzioni root, rootMargin e threshold e distingui l’intersezione dalla visibilità effettiva.

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

Sintassi

new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })

IntersectionObserver è una Web API del browser, non una funzionalità di ECMAScript. La disponibilità in Node 24 non dimostra il supporto del browser; verifica l’ambiente di destinazione.

root definisce la regione di riferimento; il valore predefinito null indica il viewport. rootMargin ne amplia o restringe i confini usando da 1 a 4 valori in pixel o percentuali. Questi scostamenti si applicano solo agli elementi osservati dello stesso dominio di origine (same-origin-domain) e vengono ignorati per quelli di un dominio di origine diverso (cross-origin-domain). threshold accetta un numero o un array nell’intervallo [0, 1] e il valore predefinito è 0. La proprietà di sola lettura thresholds espone i rapporti dell’area dell’elemento ordinati.

Dopo l’avvio dell’osservazione, la callback riceve normalmente una voce iniziale per l’elemento osservato, ma la consegna non è garantita. L’osservazione può interrompersi prima che la voce venga generata, e takeRecords() può rimuoverla dalla coda prima che raggiunga la callback. Le voci successive vengono accodate quando viene superata una soglia o cambia isIntersecting. L’intersezione geometrica non dimostra la visibilità effettiva; bordi che si toccano possono produrre isIntersecting === true con un’area di intersezione pari a zero.

observe(target) avvia l’osservazione, unobserve(target) la interrompe per un singolo elemento e disconnect() per tutti. L’esempio verifica l’intersezione iniziale completa e poi ripulisce le risorse.

Esempi

(() => {
  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);
})();

Risultato

true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti