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.