Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje