CKTIS / JavaScript
IntersectionObserverEntry — de intersectie van een element uitlezen
IntersectionObserverEntry beschrijft de intersectie van een geobserveerd element met de root op een vastgelegd moment. De eigenschappen isIntersecting, target en intersectionRatio geven de intersectiestatus, het element en het deel van het oppervlak dat intersecteert weer.
Versie: 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 is een momentopname van de geometrie, geen object dat continu wordt bijgewerkt. De browser levert entries asynchroon aan een callback van IntersectionObserver; wachtende entries kunnen ook met takeRecords() worden opgehaald. De callback hoort de volledige array entries te verwerken, niet alleen de eerste entry.
IntersectionObserverEntry.target verwijst naar het geobserveerde Element. IntersectionObserverEntry.isIntersecting is een boolean die aangeeft of er een intersectie met de root is. IntersectionObserverEntry.intersectionRatio is een getal van 0 tot 1: de oppervlakte van intersectionRect gedeeld door die van boundingClientRect. Bij een target met een oppervlakte van nul is de waarde 1 wanneer isIntersecting true is, en anders 0; beschouw deze twee eigenschappen niet als gelijkwaardig.
De eerste melding beschrijft de begintoestand na observe(). Latere meldingen hangen onder meer af van het overschrijden van ingestelde threshold-waarden; het is geen rapport van elke gescrollde pixel. Als je wilt reageren wanneer de helft van het oppervlak intersecteert, neem dan de drempel 0.5 op en controleer entry.isIntersecting && entry.intersectionRatio >= 0.5. Gewone geometrische observatie bewijst niet dat een ander element het target niet bedekt.
Dit is een browser-Web-API, geen functie van een bepaalde ECMAScript-editie. MDN geeft aan dat de basisinterface sinds maart 2019 breed beschikbaar is; aanvullende functies kunnen een andere ondersteuning hebben. De aanwezigheid van Node 24 in een repository toont niet aan dat de API beschikbaar is. Het voorbeeld plaatst een target van 100px hoog in een afsnijdende root van 50px hoog en stopt daarna de observatie.
Voorbeelden
(() => {
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);
})();Resultaat
true true 0.50
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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