Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

rootMargin je niz znakova s jednom do četiri vrijednosti izražene kao apsolutne duljine u CSS-u ili postoci, raspoređene kao kod CSS svojstva margin: gore, desno, dolje, lijevo. Prema specifikaciji, apsolutne se duljine, primjerice one u cm, pri raščlanjivanju niza pretvaraju u piksele. Radi kompatibilnosti među preglednicima upotrijebi px ili % jer neki preglednici odbijaju druge apsolutne jedinice. Zadana je vrijednost svake strane 0px. 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, a entry.rootBounds je null.

threshold prihvaća jedan broj ili polje brojeva od 0 do 1, uključujući obje granice. Izostavljanje opcije ili prosljeđivanje praznog polja daje prag 0. Opcija konstruktora zove se threshold, a svojstvo samo za čitanje observer.thresholds vraća brojčano rastuće sortirano polje. Prag izvan raspona izaziva RangeError, a nevaljani rootMargin izaziva DOMException s nazivom SyntaxError.

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 promijeni entry.isIntersecting, a ne pri svakoj promjeni omjera. 0.5 znači polovicu površine graničnog pravokutnika cilja, ne korijena. Dodir rubova može dati isIntersecting: true uz intersectionRatio: 0. Ako pravokutnik cilja nema površinu, omjer je 1 ako je isIntersecting istinit, inače 0. 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 ili disconnect() 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