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

CKTIS / JavaScript

IntersectionObserverEntry: stav průniku a sledovaný prvek

`isIntersecting` říká, zda se prvek v okamžiku měření protíná s referenční oblastí. `target` určuje, ke kterému sledovanému prvku se záznam vztahuje.

Verze: Current web platform; runtime support varies

Syntaxe

entry.isIntersecting // boolean
entry.target         // Element

Mezi instanční vlastnosti IntersectionObserverEntry určené jen pro čtení patří entry.isIntersecting a entry.target. entry.isIntersecting je logická hodnota (true, pokud se prvek protíná s referenční oblastí, jinak false). entry.target je tentýž objekt DOM typu Element, který byl předán metodě observe(), nikoli kořen ani selektor. Referenční oblast může určovat například posuvný kontejner. Pokud má root výchozí hodnotu null, je referenční oblastí oblast zobrazení (viewport) dokumentu nejvyšší úrovně. U prvku uvnitř iframe se při výpočtu intersectionRect zohledňuje i oříznutí na oblast zobrazení rámce.

Záznam zachycuje měření a neaktualizuje se průběžně. Po observe() přijde první hlášení asynchronně, i když se prvek nepohnul. Další záznamy mohou hlásit změnu stavu průniku nebo překročení nastaveného prahu poměru průniku. Samotné true tedy neznamená, že prvek právě vstoupil do oblasti. Zpracuj celé pole entries: jediné volání zpětné funkce může přinést několik záznamů.

Dotyk hran se může počítat jako průnik, i když je intersectionRatio rovno 0. Pokud chceš ověřit, že geometrický průnik má kladnou plochu, zkontroluj, že platí entry.intersectionRect.width > 0 i entry.intersectionRect.height > 0. To ještě nedokazuje, že uživatel prvek vidí: může jej zakrývat jiný prvek.

Jde o API webové platformy, nikoli o součást ECMAScript 2024. Ověř, že cílové běhové prostředí poskytuje IntersectionObserver. Metodou unobserve(element) ukončíš sledování jednoho prvku, metodou disconnect() sledování všech prvků daného pozorovatele.

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:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';

  const makeTarget = (left) => {
    const element = document.createElement('div');
    element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
    root.append(element);
    return element;
  };

  const inside = makeTarget(8);
  const outside = makeTarget(150);
  document.body.append(root);

  const states = new Map();
  const observer = new IntersectionObserver((entries, currentObserver) => {
    for (const entry of entries) {
      states.set(entry.target, entry.isIntersecting);
    }
    if (!states.has(inside) || !states.has(outside)) return;

    currentObserver.disconnect();
    root.remove();
    console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
  }, { root });

  observer.observe(inside);
  observer.observe(outside);
})();
</script>
</body>
</html>

Výsledek

inside: true
outside: false

Ulož kód jako soubor HTML, otevři jej v prohlížeči a zkontroluj výstup ve vývojářské konzoli. První prvek je uvnitř referenčního kontejneru, druhý je celý mimo něj. Kód počká na oba počáteční záznamy, vypíše stavy v pevném pořadí a poté po sobě uklidí.

Související lekce

  • JavaScript · Lekce 30 · Středně pokročilá · Verze: 3

Zdroje