Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IntersectionObserver.observe — začatie sledovania prvku

Metóda observe(target) zaregistruje prvok na asynchrónne sledovanie jeho prieniku s root podľa konfigurácie observera.

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

Syntax

observer.observe(target)

observer.observe(target) prijíma Element a vracia undefined. Opätovná registrácia toho istého prvku nič nemení. Jeden observer môže sledovať viacero prvkov. root, rootMargin a threshold nastavte v konštruktore, nie v observe().

Keď prehliadač prvýkrát vyhodnotí zaregistrovaný prvok, zaradí do frontu počiatočný záznam, aj keď k prieniku nedochádza. Záznamy z frontu sa callbacku odovzdávajú asynchrónne, no počiatočný záznam sa k nemu nemusí dostať: unobserve(target) môže zastaviť sledovanie skôr, než záznam vznikne, a takeRecords() ho môže z frontu odobrať pred odovzdaním. Prekročenie prahovej hodnoty alebo zmena isIntersecting môže viesť k zaradeniu ďalšieho záznamu do frontu. Callback dostáva pole záznamov. Geometrický prienik nedokazuje, že sú pixely skutočne viditeľné.

unobserve(target) zastaví sledovanie jedného prvku, zatiaľ čo disconnect() zastaví sledovanie všetkých. Ide o webové API prehliadača, nie o funkciu konkrétnej edície ECMAScriptu. Dostupnosť overte v cieľovom prostredí. Samotný Node 24 nepotvrdzuje podporu tejto funkcie.

Príklady

(() => {
  if (!("IntersectionObserver" in window)) {
    throw new Error("IntersectionObserver is unavailable");
  }

  const target = document.createElement("div");
  target.style.display = "none";
  document.body.append(target);

  const observer = new IntersectionObserver((entries) => {
    console.log("initial:", entries[0].isIntersecting);
    observer.disconnect();
    target.remove();
  });

  observer.observe(target);
  observer.observe(target);
  console.log("started");
})();

Výsledok

started
initial: false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje