Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IntersectionObserverEntry: stanje presijecanja i promatrani element

`isIntersecting` govori presijeca li element referentno područje u trenutku mjerenja, a `target` određuje na koji se promatrani element zapis odnosi.

Verzija: Current web platform; runtime support varies

Sintaksa

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

Među svojstvima instance IntersectionObserverEntry koja su samo za čitanje nalaze se entry.isIntersecting i entry.target. entry.isIntersecting je logička vrijednost (true ako element presijeca referentno područje, inače false). entry.target je isti objekt DOM-a tipa Element koji je proslijeđen metodi observe(), a ne korijen ili selektor. Referentno područje može određivati, primjerice, spremnik s pomicanjem sadržaja. Kada root ima zadanu vrijednost null, referentno područje je područje prikaza (viewport) dokumenta najviše razine. Za element u okviru iframe pri izračunu intersectionRect uzima se u obzir i obrezivanje na granice područja prikaza okvira.

Zapis bilježi mjerenje i ne ažurira se uživo. Nakon observe() prva obavijest stiže asinkrono, čak i ako se element nije pomaknuo. Kasniji zapisi mogu javiti promjenu stanja presijecanja ili prelazak preko postavljenog praga omjera presjeka. Zato true samo po sebi ne znači da je element upravo ušao u područje. Obradi cijelo polje entries: jedan poziv povratne funkcije može dostaviti više zapisa.

Dodir rubova može se računati kao presijecanje čak i kada je intersectionRatio jednak 0. Za provjeru ima li geometrijski presjek pozitivnu površinu provjeri oba uvjeta: entry.intersectionRect.width > 0 i entry.intersectionRect.height > 0. To ne dokazuje da korisnik vidi element: drugi ga element može prekriti.

Ovaj API pripada web-platformi, a nije dio standarda ECMAScript 2024. Provjeri pruža li ciljno okruženje IntersectionObserver. Upotrijebi unobserve(element) da prestaneš promatrati jedan element ili disconnect() da prekineš promatranje svih elemenata tog promatrača.

Primjeri

<!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>

Rezultat

inside: true
outside: false

Spremi kôd kao HTML datoteku, otvori je u pregledniku i provjeri ispis u razvojnoj konzoli. Prvi je element unutar referentnog spremnika, a drugi je potpuno izvan njega. Kôd čeka oba početna zapisa, ispisuje stanja stalnim redoslijedom i zatim čisti za sobom.

Povezane lekcije

  • JavaScript · Lekcija 30 · Srednje · Verzija: 3

Izvori