Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IntersectionObserver: praćenje presjeka elemenata

IntersectionObserver asinkrono prijavljuje geometrijski presjek između elementa i referentnog područja. Upoznajte opcije root, rootMargin i threshold te razlikujte presjek od stvarne vidljivosti.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })

IntersectionObserver je web API preglednika, a ne značajka ECMAScripta. Dostupnost u Nodeu 24 ne potvrđuje podršku preglednika; provjerite ciljano okruženje.

root određuje referentno područje; zadana vrijednost null znači viewport. rootMargin proširuje ili sužava njegove granice pomoću 1–4 vrijednosti u pikselima ili postocima. Ti se pomaci primjenjuju samo na ciljne elemente s istom domenom podrijetla (same-origin-domain), a zanemaruju se za ciljne elemente s drugom domenom podrijetla (cross-origin-domain). threshold prihvaća broj ili polje u rasponu [0, 1], a zadana je vrijednost 0. Svojstvo thresholds, dostupno samo za čitanje, izlaže sortirane omjere površine ciljnog elementa.

Nakon početka praćenja povratni poziv obično prima početni zapis za ciljni element, ali isporuka nije zajamčena. Praćenje može završiti prije nego što zapis nastane, a takeRecords() ga može ukloniti iz reda čekanja prije nego što stigne do povratnog poziva. Naknadni se zapisi dodaju u red čekanja pri prelasku praga ili promjeni vrijednosti isIntersecting. Geometrijski presjek ne dokazuje stvarnu vidljivost; dodirivanje rubova može dati isIntersecting === true uz površinu presjeka jednaku nuli.

observe(target) započinje praćenje, unobserve(target) zaustavlja ga za jedan cilj, a disconnect() za sve. Primjer provjerava početni potpuni presjek i zatim čisti resurse.

Primjeri

(() => {
  if (!("IntersectionObserver" in window)) {
    throw new Error("IntersectionObserver unavailable");
  }
  const root = document.createElement("div");
  root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
  const target = document.createElement("div");
  target.style.cssText = "width:20px;height:20px;margin:0;";
  root.append(target);
  document.body.append(root);

  const observer = new IntersectionObserver((entries) => {
    console.log(entries[0].intersectionRatio === 1);
    observer.disconnect();
    root.remove();
  }, { root, rootMargin: "0px", threshold: [0, 1] });

  observer.observe(target);
})();

Rezultat

true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori