Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

rootMargin je niz od ene do štirih vrednosti, zapisanih kot absolutne dolžine CSS ali odstotki in razporejenih kot pri CSS margin: zgoraj, desno, spodaj, levo. Po specifikaciji se absolutne dolžine, na primer tiste v cm, pri razčlenjevanju niza pretvorijo v slikovne pike. Za združljivost med brskalniki uporabi px ali %, saj nekateri brskalniki zavrnejo druge absolutne enote. Privzeta vrednost vsake stranice je 0px. 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.rootBounds pa je null.

threshold sprejme eno število ali polje števil od 0 do vključno 1. Če možnost izpustiš ali podaš prazno polje, je prag 0. Možnost konstruktorja se imenuje threshold, lastnost observer.thresholds pa je samo za branje in vrne polje, urejeno po naraščajoči številski vrednosti. Prag zunaj območja sproži RangeError, neveljaven rootMargin pa sproži DOMException z imenom SyntaxError.

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 spremeni entry.isIntersecting, ne pa ob vsaki spremembi deleža. 0.5 pomeni polovico površine omejevalnega pravokotnika cilja, ne korena. Stik robov lahko da isIntersecting: true pri intersectionRatio: 0. Če ima pravokotnik cilja ničelno površino, je delež 1, kadar je isIntersecting resničen, sicer pa 0. 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, z disconnect() 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