CKTIS / JavaScript
IntersectionObserverEntry — leggere l’intersezione di un elemento
IntersectionObserverEntry descrive l’intersezione di un elemento osservato con la sua radice in un istante registrato. Le proprietà isIntersecting, target e intersectionRatio indicano lo stato dell’intersezione, l’elemento e la frazione della sua area che si interseca.
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
entry.isIntersecting
entry.target
entry.intersectionRatioIntersectionObserverEntry è un’istantanea geometrica, non un oggetto aggiornato continuamente. Il browser invia le voci in modo asincrono a una funzione di callback IntersectionObserver; le voci in attesa possono essere recuperate anche tramite takeRecords(). La funzione di callback dovrebbe elaborare l’intero array entries, non solo la prima voce.
IntersectionObserverEntry.target fa riferimento all’Element osservato. IntersectionObserverEntry.isIntersecting è un booleano che indica se è presente un’intersezione con la radice. IntersectionObserverEntry.intersectionRatio è un numero da 0 a 1: l’area di intersectionRect divisa per quella di boundingClientRect. Per un target con area pari a zero, il valore è 1 quando isIntersecting è true e 0 altrimenti; non considerare equivalenti queste due proprietà.
La prima notifica descrive lo stato iniziale dopo observe(). Le notifiche successive dipendono, tra le altre cose, dal superamento dei valori threshold configurati; non riportano ogni pixel di scorrimento. Per reagire quando si interseca metà dell’area, includi la soglia 0.5 e verifica entry.isIntersecting && entry.intersectionRatio >= 0.5. La normale osservazione geometrica non dimostra che un altro elemento non copra il target.
Questa è una Web API del browser, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che l’interfaccia principale è ampiamente disponibile da marzo 2019; le funzionalità aggiuntive possono avere un supporto diverso. La presenza di Node 24 in un repository non dimostra che l’API sia disponibile. L’esempio colloca un target alto 100px dentro una radice di ritaglio alta 50px, quindi interrompe l’osservazione.
Esempi
(() => {
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);
})();Risultato
true true 0.50
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
- IntersectionObserverEntry - Web APIs | MDN
- IntersectionObserverEntry: isIntersecting property - Web APIs | MDN
- IntersectionObserverEntry: target property - Web APIs | MDN
- IntersectionObserverEntry: intersectionRatio property - Web APIs | MDN
- Intersection Observer API - Web APIs | MDN
- IntersectionObserver: IntersectionObserver() constructor - Web APIs | MDN
- IntersectionObserver: observe() method - Web APIs | MDN