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.