CKTIS / JavaScript
Opcije IntersectionObservera: root, rootMargin i threshold
`root` bira referentno područje, `rootMargin` prilagođava njegove granice za izračun, a `threshold` određuje udjele površine cilja pri kojima se šalju obavijesti.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: [0, 0.5, 1] })IntersectionObserver je API preglednika, a ne dio ECMAScripta. root bira referentno područje: ako ga izostaviš ili proslijediš null, koristi se vidljivo područje dokumenta najviše razine. Kao izričit korijen možeš zadati Document ili Element, primjerice pomični spremnik. Ako je korijen element, cilj mora biti njegov potomak u lancu blokova koji ga sadržavaju u rasporedu stranice.
rootMarginje niz znakova s jednom do četiri vrijednosti izražene kao apsolutne duljine u CSS-u ili postoci, raspoređene kao kod CSS svojstvamargin: gore, desno, dolje, lijevo. Prema specifikaciji, apsolutne se duljine, primjerice one ucm, pri raščlanjivanju niza pretvaraju u piksele. Radi kompatibilnosti među preglednicima upotrijebipxili%jer neki preglednici odbijaju druge apsolutne jedinice. Zadana je vrijednost svake strane0px. Postoci se računaju prema širini izvornog pravokutnika korijena, čak i gore i dolje. Pozitivne vrijednosti povećavaju pravokutnik za izračun, a negativne ga smanjuju. To ne mijenja raspored niti poništava obrezivanje koje uzrokuju posredni preci. Za ciljeve s drugim podrijetlom margina se zanemaruje, aentry.rootBoundsjenull.
thresholdprihvaća jedan broj ili polje brojeva od0do1, uključujući obje granice. Izostavljanje opcije ili prosljeđivanje praznog polja daje prag0. Opcija konstruktora zove sethreshold, a svojstvo samo za čitanjeobserver.thresholdsvraća brojčano rastuće sortirano polje. Prag izvan raspona izazivaRangeError, a nevaljanirootMarginizazivaDOMExceptions nazivomSyntaxError.
Nakon
observe(target)povratna funkcija asinkrono prima početni zapis, čak i ako nema presjeka. Daljnji se zapisi stavljaju u red kada omjer prijeđe prag u bilo kojem smjeru ili kada se promijenientry.isIntersecting, a ne pri svakoj promjeni omjera.0.5znači polovicu površine graničnog pravokutnika cilja, ne korijena. Dodir rubova može datiisIntersecting: trueuzintersectionRatio: 0. Ako pravokutnik cilja nema površinu, omjer je1ako jeisIntersectingistinit, inače0. Geometrijski presjek ne dokazuje da korisnik vidi cilj.
Opcije se utvrđuju pri stvaranju promatrača. Za promjenu opcija stvori novog promatrača. Upotrijebi
unobserve(target)za prestanak promatranja jednog cilja ilidisconnect()za prestanak promatranja svih ciljeva. Provjeri podržava li izvršno okruženje API.
Primjeri
<!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>Rezultat
root matches: true rootMargin: 0px 0px 40px 0px thresholds: [0,0.5,1] isIntersecting: true intersectionRatio: 0.5
Spremi primjer kao HTML datoteku, otvori je u aktivnoj kartici preglednika i provjeri ispis u konzoli za razvojne programere. Cilj počinje 20 px ispod donjeg ruba korijena. Donja margina od 40 px obuhvaća polovicu visine cilja preko njegove pune širine. Početni zapis zato navodi `intersectionRatio: 0.5`. Kod odspaja promatrača i uklanja elemente demonstracije.
Povezane lekcije
- JavaScript · Lekcija 30 · Srednje · Verzija: 3
Izvori
- 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