CKTIS / JavaScript
IntersectionObserver.observe — početak praćenja elementa
Metoda observe(target) registrira element za asinkrono praćenje njegova presijecanja s rootom, prema konfiguraciji promatrača.
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
observer.observe(target)observer.observe(target) prima Element i vraća undefined. Ponovna registracija istog elementa ništa ne mijenja. Jedan promatrač može pratiti više elemenata. root, rootMargin i threshold postavite u konstruktoru, a ne u observe().
Kad preglednik prvi put provjeri registrirani element, dodaje početni zapis u red čekanja, čak i kad nema presijecanja. Zapisi iz reda čekanja asinkrono se prosljeđuju povratnom pozivu, no početni zapis ne mora stići do njega: unobserve(target) može zaustaviti praćenje prije nego što zapis nastane, a takeRecords() može ga ukloniti iz reda čekanja prije prosljeđivanja. Prelazak praga ili promjena vrijednosti isIntersecting može dovesti do dodavanja novog zapisa u red čekanja. Povratni poziv prima polje zapisa. Geometrijsko presijecanje ne dokazuje da su pikseli doista vidljivi.
unobserve(target) zaustavlja praćenje jednog elementa, a disconnect() zaustavlja praćenje svih. To je web API preglednika, a ne značajka određene edicije ECMAScripta. Provjerite dostupnost u ciljnom okruženju. Sam Node 24 ne potvrđuje podršku.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.