CKTIS / JavaScript
Možnosti IntersectionObserver: root, rootMargin in threshold
`root` izbere referenčno območje, `rootMargin` prilagodi njegove meje za izračun, `threshold` pa določi deleže površine cilja, pri katerih opazovalnik pošlje obvestilo.
Različica: 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 brskalniški API in ni del ECMAScripta. root izbere referenčno območje: če ga izpustiš ali podaš null, se uporabi vidno polje vrhnjega dokumenta. Izrecno lahko podaš Document ali Element, na primer vsebnik s pomikanjem. Če je koren element, mora biti cilj njegov potomec v verigi vsebujočih blokov postavitve.
rootMarginje niz od ene do štirih vrednosti, zapisanih kot absolutne dolžine CSS ali odstotki in razporejenih kot pri CSSmargin: zgoraj, desno, spodaj, levo. Po specifikaciji se absolutne dolžine, na primer tiste vcm, pri razčlenjevanju niza pretvorijo v slikovne pike. Za združljivost med brskalniki uporabipxali%, saj nekateri brskalniki zavrnejo druge absolutne enote. Privzeta vrednost vsake stranice je0px. Odstotki se izračunajo iz širine prvotnega pravokotnika korena, tudi zgoraj in spodaj. Pozitivne vrednosti povečajo pravokotnik za izračun, negativne ga zmanjšajo. Postavitev se ne spremeni in obrezovanje zaradi vmesnih prednikov ostane v veljavi. Pri ciljih z drugim izvorom se odmik prezre,entry.rootBoundspa jenull.
thresholdsprejme eno število ali polje števil od0do vključno1. Če možnost izpustiš ali podaš prazno polje, je prag0. Možnost konstruktorja se imenujethreshold, lastnostobserver.thresholdspa je samo za branje in vrne polje, urejeno po naraščajoči številski vrednosti. Prag zunaj območja sprožiRangeError, neveljavenrootMarginpa sprožiDOMExceptionz imenomSyntaxError.
Po
observe(target)povratna funkcija asinhrono prejme začetni zapis, tudi če ni preseka. Nadaljnji zapisi se uvrstijo v čakalno vrsto, ko delež preide prag v katero koli smer ali se spremenientry.isIntersecting, ne pa ob vsaki spremembi deleža.0.5pomeni polovico površine omejevalnega pravokotnika cilja, ne korena. Stik robov lahko daisIntersecting: truepriintersectionRatio: 0. Če ima pravokotnik cilja ničelno površino, je delež1, kadar jeisIntersectingresničen, sicer pa0. Geometrijski presek ne dokazuje, da uporabnik vidi cilj.
Možnosti so določene ob ustvarjanju opazovalnika. Če jih želiš spremeniti, ustvari novega. Z
unobserve(target)prenehaš opazovati en cilj, zdisconnect()pa vse cilje. Preveri, ali okolje, v katerem se bo koda izvajala, podpira API.
Primeri
<!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
Shrani primer kot datoteko HTML, odpri jo v aktivnem zavihku brskalnika in preveri izpis v razvijalski konzoli. Cilj se začne 20 px pod spodnjim robom korena. Spodnji odmik 40 px zajame polovico višine cilja po vsej njegovi širini. Začetni zapis zato navede `intersectionRatio: 0.5`. Koda odklopi opazovalnik in odstrani predstavitvene elemente.
Povezane lekcije
- JavaScript · Lekcija 30 · Srednja · Različica: 3
Viri
- 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