CKTIS / JavaScript
IntersectionObserver: sledování průniků prvků
IntersectionObserver asynchronně oznamuje geometrický průnik mezi prvkem a referenční oblastí. Seznamte se s možnostmi root, rootMargin a threshold a rozlišujte průnik od skutečné viditelnosti.
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
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })IntersectionObserver je webové API prohlížeče, nikoli funkce ECMAScriptu. Dostupnost v Node 24 nepotvrzuje podporu v prohlížeči; ověřte cílové prostředí.
root určuje referenční oblast; výchozí null znamená viewport. rootMargin rozšiřuje nebo zužuje její hranice pomocí 1–4 hodnot v pixelech nebo procentech. Tyto posuny se uplatní jen u cílových prvků se stejnou doménou původu (same-origin-domain); u prvků s jinou doménou původu (cross-origin-domain) se ignorují. threshold přijímá číslo nebo pole v rozsahu [0, 1]; výchozí hodnota je 0. Vlastnost thresholds pouze pro čtení poskytuje seřazené poměry plochy cílového prvku.
Po zahájení sledování callback obvykle obdrží počáteční záznam pro cílový prvek, jeho doručení však není zaručeno. Sledování může skončit dříve, než záznam vznikne, a takeRecords() může záznam vybrat z fronty dříve, než se předá callbacku. Další záznamy se zařazují do fronty při překročení prahu nebo změně isIntersecting. Geometrický průnik nedokazuje skutečnou viditelnost; dotýkající se okraje mohou vést k isIntersecting === true, přestože je plocha průniku nulová.
observe(target) zahájí sledování, unobserve(target) je ukončí pro jeden cíl a disconnect() pro všechny. Příklad ověřuje počáteční úplný průnik a následně uklidí prostředky.
Pří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ýsledek
true
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.