CKTIS / JavaScript
IntersectionObserver: sledovanie prienikov prvkov
IntersectionObserver asynchrónne oznamuje geometrický prienik medzi prvkom a referenčnou oblasťou. Spoznajte možnosti root, rootMargin a threshold a rozlišujte prienik od skutočnej viditeľnosti.
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
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })IntersectionObserver je webové API prehliadača, nie funkcia ECMAScriptu. Dostupnosť v Node 24 nepotvrdzuje podporu v prehliadači; overte cieľové prostredie.
root určuje referenčnú oblasť; predvolená hodnota null znamená viewport. rootMargin rozširuje alebo zužuje jej hranice pomocou 1–4 hodnôt v pixeloch alebo percentách. Tieto posuny sa uplatňujú len pri cieľových prvkoch s rovnakou doménou pôvodu (same-origin-domain); pri prvkoch s inou doménou pôvodu (cross-origin-domain) sa ignorujú. threshold prijíma číslo alebo pole v rozsahu [0, 1]; predvolená hodnota je 0. Vlastnosť thresholds iba na čítanie poskytuje zoradené pomery plochy cieľového prvku.
Po spustení sledovania callback zvyčajne dostane počiatočný záznam pre cieľový prvok, jeho doručenie však nie je zaručené. Sledovanie sa môže skončiť skôr, ako záznam vznikne, a takeRecords() ho môže vybrať z frontu skôr, ako sa odovzdá callbacku. Ďalšie záznamy sa zaraďujú do frontu pri prekročení prahu alebo zmene isIntersecting. Geometrický prienik nedokazuje skutočnú viditeľnosť; dotýkajúce sa okraje môžu viesť k isIntersecting === true, hoci je plocha prieniku nulová.
observe(target) spustí sledovanie, unobserve(target) ho ukončí pre jeden cieľ a disconnect() pre všetky. Príklad overí počiatočný úplný prienik a následne uvoľní prostriedky.
Príklady
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver unavailable");
}
const root = document.createElement("div");
root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
const target = document.createElement("div");
target.style.cssText = "width:20px;height:20px;margin:0;";
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
console.log(entries[0].intersectionRatio === 1);
observer.disconnect();
root.remove();
}, { root, rootMargin: "0px", threshold: [0, 1] });
observer.observe(target);
})();Výsledok
true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.