CKTIS / JavaScript
IntersectionObserverEntry — die Schnittmenge eines Elements auslesen
IntersectionObserverEntry beschreibt die Schnittmenge eines beobachteten Elements mit dem Root zu einem erfassten Zeitpunkt. Mit den Eigenschaften isIntersecting, target und intersectionRatio lassen sich der Schnittmengenstatus, das Element und der Anteil seiner Fläche bestimmen, der sich mit dem Root überschneidet.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
entry.isIntersecting
entry.target
entry.intersectionRatioIntersectionObserverEntry ist eine Geometrie-Momentaufnahme und kein kontinuierlich aktualisiertes Objekt. Der Browser übermittelt Einträge asynchron an den Callback eines IntersectionObserver; ausstehende Einträge lassen sich auch über takeRecords() abrufen. Der Callback sollte das gesamte Array entries verarbeiten, nicht nur den ersten Eintrag.
IntersectionObserverEntry.target verweist auf das beobachtete Element. IntersectionObserverEntry.isIntersecting ist ein boolescher Wert, der angibt, ob eine Schnittmenge mit dem Root besteht. IntersectionObserverEntry.intersectionRatio ist eine Zahl zwischen 0 und 1: die Fläche von intersectionRect geteilt durch die Fläche von boundingClientRect. Bei einem Ziel mit einer Fläche von null ist der Wert 1, wenn isIntersecting true ist, andernfalls 0; setze diese beiden Eigenschaften nicht gleich.
Die erste Benachrichtigung beschreibt den Anfangszustand nach observe(). Weitere Benachrichtigungen hängen unter anderem davon ab, ob konfigurierte threshold-Werte überschritten werden; es handelt sich nicht um einen Bericht zu jedem gescrollten Pixel. Um bei der Hälfte der Fläche zu reagieren, nimm den Schwellenwert 0.5 auf und prüfe entry.isIntersecting && entry.intersectionRatio >= 0.5. Eine gewöhnliche Geometrie-Beobachtung beweist nicht, dass kein anderes Element das Ziel verdeckt.
Dies ist eine browserbasierte Web-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet die Kernschnittstelle seit März 2019 als allgemein verfügbar; zusätzliche Funktionen können eine andere Unterstützung haben. Dass sich Node 24 in einem Repository befindet, belegt nicht die Verfügbarkeit der API. Das Beispiel platziert ein 100px hohes Ziel in einem beschneidenden Root mit einer Höhe von 50px und beendet anschließend die Beobachtung.
Beispiele
(() => {
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);
})();Ergebnis
true true 0.50
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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