Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.intersectionRatio

IntersectionObserverEntry è 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