CKTIS / JavaScript
IntersectionObserver: intersecties van elementen observeren
IntersectionObserver meldt asynchroon de geometrische intersectie tussen een element en een referentiegebied. Leer de opties root, rootMargin en threshold kennen en onderscheid intersectie van daadwerkelijke zichtbaarheid.
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
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })IntersectionObserver is een browser-Web-API, geen ECMAScript-functie. Beschikbaarheid in Node 24 bewijst niet dat de browser de API ondersteunt; controleer de doelomgeving.
root bepaalt het referentiegebied; de standaardwaarde null betekent de viewport. rootMargin vergroot of verkleint de grenzen met 1–4 waarden in pixels of percentages. Deze verschuivingen gelden alleen voor doelelementen met hetzelfde herkomstdomein (same-origin-domain); voor doelelementen met een ander herkomstdomein (cross-origin-domain) worden ze genegeerd. threshold accepteert een getal of array binnen [0, 1] en is standaard 0. De alleen-lezen eigenschap thresholds geeft de gesorteerde verhoudingen van het doeloppervlak weer.
Zodra de observatie is gestart, ontvangt de callback normaal gesproken een eerste vermelding voor het doelelement, maar dat is niet gegarandeerd. De observatie kan stoppen voordat de vermelding wordt aangemaakt, en takeRecords() kan de vermelding uit de wachtrij halen voordat die de callback bereikt. Latere vermeldingen worden in de wachtrij geplaatst wanneer een drempel wordt gepasseerd of isIntersecting verandert. Geometrische intersectie bewijst geen daadwerkelijke zichtbaarheid; elkaar rakende randen kunnen isIntersecting === true opleveren terwijl het intersectieoppervlak nul is.
observe(target) start het observeren, unobserve(target) stopt dit voor één doel en disconnect() stopt dit voor alle doelen. Het voorbeeld controleert de aanvankelijke volledige intersectie en ruimt daarna op.
Voorbeelden
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver unavailable");
}
const root = document.createElement("div");
root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
const target = document.createElement("div");
target.style.cssText = "width:20px;height:20px;margin:0;";
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
console.log(entries[0].intersectionRatio === 1);
observer.disconnect();
root.remove();
}, { root, rootMargin: "0px", threshold: [0, 1] });
observer.observe(target);
})();Resultaat
true
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.