CKTIS / JavaScript
IntersectionObserverEntry: stato di intersezione ed elemento osservato
`isIntersecting` indica se l’elemento interseca l’area di riferimento al momento della misurazione, mentre `target` identifica l’elemento osservato a cui si riferisce la voce.
Versione: Current web platform; runtime support varies
Sintassi
entry.isIntersecting // boolean
entry.target // ElementTra le proprietà di istanza di sola lettura di IntersectionObserverEntry ci sono entry.isIntersecting ed entry.target. entry.isIntersecting è un booleano (true se l’elemento interseca l’area di riferimento, false altrimenti). entry.target è lo stesso oggetto DOM di tipo Element passato a observe(), non la radice né un selettore. Come riferimento si può usare, ad esempio, un contenitore scorrevole. Quando root è null (il valore predefinito), l’area di riferimento è il viewport del documento di livello superiore. Per un elemento all’interno di un iframe, nel calcolo di intersectionRect si applica anche il ritaglio ai limiti del viewport del frame.
Una voce registra una misurazione e non si aggiorna in tempo reale. Dopo observe(), la prima notifica arriva in modo asincrono anche se l’elemento non si è spostato. Le voci successive possono segnalare un cambiamento dello stato di intersezione o il superamento di una soglia configurata per il rapporto di intersezione. Quindi true da solo non significa che l’elemento sia appena entrato. Elabora l’intero array entries: una singola chiamata alla funzione di callback può fornire più voci.
Il contatto tra i bordi può contare come intersezione anche se intersectionRatio vale 0. Per verificare che l’intersezione geometrica abbia area positiva, controlla che valgano sia entry.intersectionRect.width > 0 sia entry.intersectionRect.height > 0. Questo non dimostra che l’utente possa vedere l’elemento: un altro elemento potrebbe coprirlo.
Questa API fa parte della piattaforma web, non di ECMAScript 2024. Verifica che l’ambiente di esecuzione di destinazione fornisca IntersectionObserver. Usa unobserve(element) per smettere di osservare un elemento o disconnect() per smettere di osservare tutti gli elementi di quell’osservatore.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IntersectionObserverEntry example</title>
</head>
<body>
<script>
(() => {
const root = document.createElement('div');
root.style.cssText = 'position:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';
const makeTarget = (left) => {
const element = document.createElement('div');
element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
root.append(element);
return element;
};
const inside = makeTarget(8);
const outside = makeTarget(150);
document.body.append(root);
const states = new Map();
const observer = new IntersectionObserver((entries, currentObserver) => {
for (const entry of entries) {
states.set(entry.target, entry.isIntersecting);
}
if (!states.has(inside) || !states.has(outside)) return;
currentObserver.disconnect();
root.remove();
console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
}, { root });
observer.observe(inside);
observer.observe(outside);
})();
</script>
</body>
</html>Risultato
inside: true outside: false
Salva il codice come file HTML, aprilo in un browser e controlla il risultato nella console per sviluppatori. Il primo elemento è dentro il contenitore di riferimento, mentre il secondo è completamente fuori. Il codice attende entrambe le voci iniziali, stampa gli stati in un ordine fisso e poi rimuove ciò che ha creato.
Lezioni correlate
- JavaScript · Lezione 30 · Intermedio · Versione: 3
Fonti
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserverEntry: target property
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserver: observe() method
- IntersectionObserver: IntersectionObserver() constructor
- Intersection Observer API
- HTML Standard — Event loops
- ECMAScript® 2024 Language Specification — Scope
- Intersection Observer specification