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

CKTIS / JavaScript

IntersectionObserverEntry: isIntersecting, intersectionRatio a target

Zjisti stav průniku, podíl plochy průniku a pozorovaný prvek. Rozlišuj stav průniku od překročení prahové hodnoty.

Verze: Current web platform; runtime support varies

Syntaxe

entry.isIntersecting     // boolean
entry.intersectionRatio // number in [0, 1]
entry.target            // Element

IntersectionObserverEntry zachycuje stav jednoho cíle v okamžiku měření. Zpětné volání pozorovatele dostává záznamy asynchronně a může jich dostat několik najednou. entry.target je tentýž objekt Element, který byl předán do observe(), nikoli root. Všechny tři vlastnosti jsou jen pro čtení, ale samotný prvek lze dál měnit. Jde o API webové platformy, nikoli součást ECMAScript 2024.

entry.isIntersecting je logická hodnota určující, zda se cíl při měření protíná s referenční oblastí pozorovatele. Při výchozím nastavení root: null je referenční oblastí zobrazovací oblast dokumentu nejvyšší úrovně, nikoli zobrazovací oblast rámce iframe, ve kterém se cíl nachází. Zobrazovací oblast rámce však může vypočtený průnik omezit. true popisuje stav, ne nutně přechod do něj. Podle specifikace se za průnik může počítat i pouhý dotyk hran s nulovou plochou průniku.

entry.intersectionRatio je číslo od 0 do 1: plocha intersectionRect dělená plochou boundingClientRect cíle, nikoli plochou referenční oblasti. Má-li obdélník cíle nulovou plochu, je výsledkem 1, pokud je isIntersecting rovno true, jinak 0. Výchozí měření je geometrické; nedokazuje, že cíl nezakrývá jiný prvek.

Po volání observe() dostaneš první záznam, i když je cíl mimo referenční oblast. Další záznamy mohou vzniknout při překročení prahu v libovolném směru nebo při změně isIntersecting. Záznam nedostaneš při každé změně poměru. threshold: 0.5 nastavuje práh pro oznámení, zatímco entry.intersectionRatio >= 0.5 testuje hodnotu konkrétního záznamu.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IntersectionObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const root = document.createElement('div');
  root.style.cssText = 'position:relative;overflow:hidden;width:100px;height:100px';
  const target = document.createElement('div');
  target.style.cssText = 'position:absolute;left:0;top:50px;width:100px;height:100px;background:royalblue';
  root.append(target);
  document.body.append(root);

  let moved = false;
  const observer = new IntersectionObserver((entries) => {
    for (const entry of entries) {
      console.log(`${entry.isIntersecting} ${entry.intersectionRatio} ${entry.target === target}`);
      if (!moved) {
        moved = true;
        target.style.top = '150px';
      } else {
        observer.disconnect();
        root.remove();
      }
    }
  }, { root, threshold: 0.5 });
  observer.observe(target);
})();
</script>
</body>
</html>

Výsledek

true 0.5 true
false 0 true

Ulož příklad jako soubor HTML a otevři ho na samostatné kartě v prohlížeči, který toto API podporuje. Otevři vývojářskou konzoli a znovu načti stránku. První záznam ukazuje, že průnik zabírá polovinu plochy cíle. Kód přesune cíl zcela mimo referenční oblast a druhý záznam ukáže, že už k průniku nedochází. Oba záznamy odkazují na stejný prvek. Po druhém kód ukončí pozorování a odstraní referenční oblast.

Související lekce

  • JavaScript · Lekce 37 · Pokročilá · Verze: 4

Zdroje