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

CKTIS / JavaScript

IntersectionObserverEntry: isIntersecting, intersectionRatio a target

Zisti stav prieniku, podiel plochy prieniku a pozorovaný prvok. Rozlišuj stav prieniku od prechodu cez prahovú hodnotu.

Verzia: Current web platform; runtime support varies

Syntax

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

IntersectionObserverEntry zachytáva stav jedného cieľa v okamihu merania. Funkcia spätného volania pozorovateľa dostáva záznamy asynchrónne a môže ich dostať viac naraz. entry.target je ten istý objekt Element, ktorý bol odovzdaný do observe(), nie root. Všetky tri vlastnosti sú len na čítanie, samotný prvok sa však dá naďalej meniť. Ide o API webovej platformy, nie o súčasť ECMAScript 2024.

entry.isIntersecting je logická hodnota, ktorá určuje, či sa cieľ pri meraní pretína s referenčnou oblasťou pozorovateľa. Pri predvolenom nastavení root: null je referenčnou oblasťou zobrazovacia oblasť dokumentu najvyššej úrovne, nie zobrazovacia oblasť rámca iframe, v ktorom sa cieľ nachádza. Zobrazovacia oblasť rámca však môže vypočítaný prienik obmedziť. true opisuje stav, nie nevyhnutne prechod doň. Podľa špecifikácie sa za prienik môže počítať aj samotný dotyk hrán s nulovou plochou prieniku.

entry.intersectionRatio je číslo od 0 do 1: plocha intersectionRect vydelená plochou boundingClientRect cieľa, nie plochou referenčnej oblasti. Ak má obdĺžnik cieľa nulovú plochu, výsledkom je 1, ak je isIntersecting rovné true, inak 0. Predvolené meranie je geometrické a nedokazuje, že cieľ nezakrýva iný prvok.

Po volaní observe() dostaneš prvý záznam, aj keď je cieľ mimo referenčnej oblasti. Ďalšie záznamy môžu vzniknúť pri prechode cez prah v ktoromkoľvek smere alebo pri zmene isIntersecting. Nie každá zmena pomeru vytvorí záznam. threshold: 0.5 nastavuje prah pre oznámenia, zatiaľ čo entry.intersectionRatio >= 0.5 testuje hodnotu konkrétneho záznamu.

Prí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ýsledok

true 0.5 true
false 0 true

Ulož príklad ako súbor HTML a otvor ho na samostatnej karte v prehliadači, ktorý toto API podporuje. Otvor vývojársku konzolu a znova načítaj stránku. Prvý záznam ukazuje, že prienik zaberá polovicu plochy cieľa. Kód presunie cieľ úplne mimo referenčnej oblasti a druhý záznam ukáže, že už k prieniku nedochádza. Oba záznamy odkazujú na ten istý prvok. Po druhom kód ukončí pozorovanie a odstráni referenčnú oblasť.

Súvisiace lekcie

  • JavaScript · Lekcia 37 · Pokročilá · Verzia: 4

Zdroje