CKTIS / JavaScript
IntersectionObserverEntry: Überschneidungszustand und beobachtetes Element
`isIntersecting` gibt an, ob sich das Element zum Messzeitpunkt mit dem Bezugsbereich überschneidet. `target` gibt an, welches beobachtete Element der Eintrag beschreibt.
Version: Current web platform; runtime support varies
Syntax
entry.isIntersecting // boolean
entry.target // ElementZu den schreibgeschützten Instanzeigenschaften von IntersectionObserverEntry gehören entry.isIntersecting und entry.target. entry.isIntersecting ist ein boolescher Wert (true bei Überschneidung mit dem Bezugsbereich, sonst false). entry.target ist dasselbe DOM-Element, das an observe() übergeben wurde, weder der Bezugsbereich noch ein Selektor. Als Bezugsbereich kann etwa ein Scrollcontainer dienen. Hat root den Standardwert null, ist der Viewport des obersten Dokuments der Bezugsbereich. Bei einem Element in einem iframe wird intersectionRect zusätzlich auf den Viewport des Frames zugeschnitten.
Ein Eintrag hält eine Messung fest und wird nicht laufend aktualisiert. Nach observe() kommt die erste Meldung asynchron, auch wenn sich das Element nicht bewegt hat. Spätere Einträge können eine Änderung des Überschneidungszustands oder das Überschreiten einer konfigurierten Schwelle für den Flächenanteil melden. true allein bedeutet daher nicht, dass das Element gerade in den Bezugsbereich gelangt ist. Verarbeite das gesamte Array entries: Ein Callback-Aufruf kann mehrere Einträge liefern.
Eine Berührung an der Kante kann als Überschneidung gelten, obwohl intersectionRatio den Wert 0 hat. Für eine geometrische Schnittfläche größer als null müssen sowohl entry.intersectionRect.width > 0 als auch entry.intersectionRect.height > 0 gelten. Das beweist nicht, dass das Element für den Nutzer sichtbar ist: Ein anderes Element kann es verdecken.
Diese API gehört zur Webplattform, nicht zu ECMAScript 2024. Prüfe, ob die Zielumgebung IntersectionObserver bereitstellt. Mit unobserve(element) beendest du die Beobachtung eines Elements, mit disconnect() die Beobachtung aller Elemente dieses Observers.
Beispiele
<!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>Ergebnis
inside: true outside: false
Speichere den Code als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Das erste Element liegt im Bezugscontainer, das zweite vollständig außerhalb. Der Code wartet auf beide ersten Einträge, gibt die Zustände in fester Reihenfolge aus und räumt anschließend auf.
Zugehörige Lektionen
- JavaScript · Lektion 30 · Mittlere Stufe · Version: 3
Quellen
- 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