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

CKTIS / JavaScript

IntersectionObserverEntry — čtení průniku prvku

IntersectionObserverEntry popisuje průnik pozorovaného prvku s kořenovou oblastí v zaznamenaném okamžiku. Vlastnosti isIntersecting, target a intersectionRatio určují stav průniku, příslušný prvek a podíl jeho plochy, který se překrývá.

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

entry.isIntersecting
entry.target
entry.intersectionRatio

IntersectionObserverEntry je geometrický snímek, nikoli průběžně aktualizovaný objekt. Prohlížeč předává záznamy asynchronně do callbacku IntersectionObserver; čekající záznamy lze získat také pomocí takeRecords(). Callback by měl zpracovat celé pole entries, nejen jeho první záznam.

IntersectionObserverEntry.target odkazuje na pozorovaný Element. IntersectionObserverEntry.isIntersecting je logická hodnota určující, zda dochází k průniku s kořenovou oblastí. IntersectionObserverEntry.intersectionRatio je číslo od 0 do 1: plocha intersectionRect dělená plochou boundingClientRect. U cíle s nulovou plochou má hodnotu 1, když je isIntersecting true, a jinak 0; tyto dvě vlastnosti nepovažujte za totožné.

První oznámení popisuje počáteční stav po zavolání observe(). Další oznámení závisejí mimo jiné na překročení nastavených hodnot threshold; nejde o hlášení každého posunutého pixelu při posouvání stránky. Chcete-li reagovat, když se protíná polovina plochy, zahrňte práh 0.5 a ověřte entry.isIntersecting && entry.intersectionRatio >= 0.5. Běžné geometrické pozorování nedokazuje, že cíl nezakrývá jiný prvek.

Jde o webové API prohlížeče, nikoli o funkci konkrétní edice ECMAScriptu. MDN uvádí, že základní rozhraní je široce dostupné od března 2019; další funkce mohou mít jinou míru podpory. Přítomnost Node 24 v repozitáři nedokládá dostupnost tohoto API. Příklad umístí cíl vysoký 100px do ořezávající kořenové oblasti vysoké 50px a poté pozorování ukončí.

Pří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ýsledek

true true 0.50

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