Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IntersectionObserverEntry — čítanie prieniku prvku

IntersectionObserverEntry opisuje prienik pozorovaného prvku s koreňovou oblasťou v zaznamenanom okamihu. Vlastnosti isIntersecting, target a intersectionRatio určujú stav prieniku, príslušný prvok a podiel jeho plochy, ktorý sa prekrýva.

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

entry.isIntersecting
entry.target
entry.intersectionRatio

IntersectionObserverEntry je geometrická snímka, nie priebežne aktualizovaný objekt. Prehliadač odovzdáva záznamy asynchrónne do callbacku IntersectionObserver; čakajúce záznamy možno získať aj pomocou takeRecords(). Callback by mal spracovať celé pole entries, nielen jeho prvý záznam.

IntersectionObserverEntry.target odkazuje na pozorovaný Element. IntersectionObserverEntry.isIntersecting je logická hodnota určujúca, či dochádza k prieniku s koreňovou oblasťou. IntersectionObserverEntry.intersectionRatio je číslo od 0 do 1: plocha intersectionRect vydelená plochou boundingClientRect. Pri cieli s nulovou plochou má hodnotu 1, keď je isIntersecting true, a inak 0; nepovažujte tieto dve vlastnosti za rovnocenné.

Prvé oznámenie opisuje počiatočný stav po zavolaní observe(). Ďalšie oznámenia závisia okrem iného od prekročenia nastavených hodnôt threshold; nejde o hlásenie každého posunutého pixela pri posúvaní stránky. Ak chcete reagovať, keď sa pretína polovica plochy, zahrňte prah 0.5 a overte entry.isIntersecting && entry.intersectionRatio >= 0.5. Bežné geometrické pozorovanie nedokazuje, že cieľ nezakrýva iný prvok.

Ide o webové API prehliadača, nie o funkciu konkrétnej edície ECMAScriptu. MDN uvádza, že základné rozhranie je široko dostupné od marca 2019; ďalšie funkcie môžu mať inú mieru podpory. Prítomnosť Node 24 v repozitári nedokladá dostupnosť tohto API. Príklad umiestni cieľ vysoký 100px do orezávajúcej koreňovej oblasti vysokej 50px a potom pozorovanie ukončí.

Príklady

(() => {
  const root = document.createElement('div');
  root.style.cssText = 'all:initial;position:fixed;top:0;left:0;width:100px;height:50px;overflow:hidden;';
  const target = document.createElement('div');
  target.style.cssText = 'all:initial;display:block;width:100px;height:100px;';
  root.append(target);
  document.body.append(root);

  const observer = new IntersectionObserver((entries) => {
    for (const entry of entries) {
      console.log(
        entry.isIntersecting,
        entry.target === target,
        entry.intersectionRatio.toFixed(2)
      );
    }
    observer.disconnect();
    root.remove();
  }, { root, threshold: [0, 0.5, 1] });

  observer.observe(target);
})();

Výsledok

true true 0.50

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje