CKTIS / JavaScript
IntersectionObserver.observe — zahájení sledování prvku
Metoda observe(target) zaregistruje prvek pro asynchronní sledování jeho průniku s root podle konfigurace observeru.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
observer.observe(target)observer.observe(target) přijímá Element a vrací undefined. Opětovná registrace stejného prvku nic nemění. Jeden observer může sledovat více prvků. root, rootMargin a threshold nastavte v konstruktoru, nikoli v observe().
Když prohlížeč poprvé vyhodnotí zaregistrovaný prvek, zařadí do fronty počáteční záznam, i když k průniku nedochází. Záznamy z fronty se callbacku předávají asynchronně, ale počáteční záznam se k němu nemusí dostat: unobserve(target) může zastavit sledování dříve, než záznam vznikne, a takeRecords() ho může z fronty odebrat před předáním. Překročení prahové hodnoty nebo změna isIntersecting může vést k zařazení dalšího záznamu do fronty. Callback dostává pole záznamů. Geometrický průnik nedokazuje, že jsou pixely skutečně viditelné.
unobserve(target) zastaví sledování jednoho prvku, zatímco disconnect() zastaví sledování všech. Jde o webové API prohlížeče, nikoli o funkci konkrétní edice ECMAScriptu. Dostupnost ověřte v cílovém prostředí. Samotný Node 24 podporu této funkce nepotvrzuje.
Pří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ýsledek
started initial: false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.