CKTIS / JavaScript
IntersectionObserver-opties: root, rootMargin en threshold
`root` kiest het referentiegebied, `rootMargin` past de grenzen ervan aan voor de berekening en `threshold` bepaalt bij welke delen van het doeloppervlak meldingen volgen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: [0, 0.5, 1] })IntersectionObserver is een browser-API, geen onderdeel van ECMAScript. root kiest het referentiegebied: als je de optie weglaat of null doorgeeft, wordt de viewport van het bovenste document gebruikt. Een expliciete root kan een Document of een Element zijn, bijvoorbeeld een scrollcontainer. Bij een element als root moet het doel er een afstammeling van zijn in de keten van omsluitende blokken die de lay-out bepalen.
rootMarginis een tekenreeks met één tot vier absolute CSS-lengtes of percentages, uitgewerkt zoals bij CSSmargin: boven, rechts, onder, links. Volgens de specificatie worden absolute lengtes, bijvoorbeeld incm, bij het verwerken van de tekenreeks naar pixels omgerekend. Gebruik voor compatibiliteit tussen browserspxof%, omdat sommige browsers andere absolute eenheden weigeren. Elke zijde is standaard0px. Percentages worden berekend op basis van de breedte van de oorspronkelijke rootrechthoek, ook boven en onder. Positieve waarden vergroten de rechthoek voor de berekening; negatieve verkleinen die. Dit verandert de lay-out niet en heft afsnijding door tussenliggende voorouders niet op. Bij doelen met een andere oorsprong wordt de marge genegeerd en isentry.rootBoundsgelijk aannull.
thresholdaccepteert één getal of een array met getallen van0tot en met1. Laat je de optie weg of geef je een lege array mee, dan geldt drempel0. De constructoroptie heetthreshold; de alleen-lezen eigenschapobserver.thresholdsgeeft een numeriek oplopend gesorteerde array terug. Een drempel buiten het bereik levert eenRangeErrorop; een ongeldigerootMarginlevert eenDOMExceptionmet de naamSyntaxErrorop.
Na
observe(target)ontvangt de callback asynchroon een eerste record, ook zonder doorsnijding. Extra records worden in de wachtrij gezet als een drempel in een van beide richtingen wordt gepasseerd ofentry.isIntersectingverandert, niet telkens als de verhouding verandert.0.5betekent de helft van het oppervlak van de begrenzingsrechthoek van het doel, niet van de root. Randcontact kanisIntersecting: trueopleveren bijintersectionRatio: 0. Bij een doelrechthoek met oppervlakte nul is de verhouding1alsisIntersectingwaar is en anders0. Een geometrische doorsnijding bewijst niet dat de gebruiker het doel kan zien.
De opties liggen vast zodra je de observer aanmaakt. Maak een nieuwe observer om ze te wijzigen. Met
unobserve(target)stop je het observeren van één doel, metdisconnect()dat van alle doelen. Controleer of de uitvoeromgeving de API ondersteunt.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IntersectionObserver options</title>
</head>
<body>
<script>
{
const root = document.createElement("div");
const spacer = document.createElement("div");
const target = document.createElement("div");
root.style.cssText = "width: 120px; height: 100px; overflow: hidden";
spacer.style.height = "120px";
target.style.cssText = "height: 40px; background: teal";
root.append(spacer, target);
document.body.append(root);
const observer = new IntersectionObserver(([entry], observer) => {
console.log(`root matches: ${observer.root === root}`);
console.log(`rootMargin: ${observer.rootMargin}`);
console.log(`thresholds: ${JSON.stringify(observer.thresholds)}`);
console.log(`isIntersecting: ${entry.isIntersecting}`);
console.log(`intersectionRatio: ${entry.intersectionRatio}`);
observer.disconnect();
root.remove();
}, {
root,
rootMargin: "0px 0px 40px",
threshold: [1, 0, 0.5],
});
observer.observe(target);
}
</script>
</body>
</html>Resultaat
root matches: true rootMargin: 0px 0px 40px 0px thresholds: [0,0.5,1] isIntersecting: true intersectionRatio: 0.5
Sla het voorbeeld op als HTML-bestand, open het in een actief browsertabblad en bekijk de uitvoer in de ontwikkelaarsconsole. Het doel begint 20 px onder de onderrand van de root. De ondermarge van 40 px omvat de helft van de doelhoogte over de volle breedte. Het eerste record meldt daarom `intersectionRatio: 0.5`. De code stopt de observer en verwijdert de demo-elementen.
Gerelateerde lessen
- JavaScript · Les 30 · Gemiddeld · Versie: 3
Bronnen
- IntersectionObserver: IntersectionObserver() constructor
- Intersection Observer API
- IntersectionObserver: rootMargin property
- Intersection Observer specification — Parse a margin
- IntersectionObserver: thresholds property
- IntersectionObserver: observe() method
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserver: disconnect() method
- HTML Standard — Update the rendering