CKTIS / JavaScript
IntersectionObserver.observe — začetek opazovanja elementa
Metoda observe(target) registrira element za asinhrono sledenje njegovemu preseku z root glede na konfiguracijo opazovalnika.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
observer.observe(target)observer.observe(target) sprejme Element in vrne undefined. Ponovna registracija istega elementa ničesar ne spremeni. En opazovalnik lahko spremlja več elementov. root, rootMargin in threshold nastavite v konstruktorju, ne v observe().
Ko brskalnik prvič preveri registrirani element, doda začetni vnos v čakalno vrsto, tudi če do preseka ne pride. Vnosi iz čakalne vrste se povratni funkciji posredujejo asinhrono, vendar ta začetnega vnosa ne prejme nujno: unobserve(target) lahko ustavi opazovanje, preden vnos nastane, takeRecords() pa ga lahko odstrani iz čakalne vrste, preden je posredovan. Prehod čez prag ali sprememba isIntersecting lahko povzroči, da se v čakalno vrsto doda nov vnos. Povratna funkcija prejme polje vnosov. Geometrijski presek ne dokazuje, da so slikovne pike dejansko vidne.
unobserve(target) ustavi spremljanje enega elementa, disconnect() pa vseh. To je spletni API brskalnika in ne funkcija določene izdaje ECMAScript. Razpoložljivost preverite v ciljnem okolju. Sam Node 24 ne potrjuje podpore.
Primeri
(() => {
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");
})();Rezultat
started initial: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.