Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IntersectionObserverEntry: isIntersecting, intersectionRatio i target

Saznaj koji se element promatra, siječe li referentno područje i koliki je udio površine presjeka. Razlikuj stanje presjeka od prelaska praga.

Verzija: Current web platform; runtime support varies

Sintaksa

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

IntersectionObserverEntry bilježi stanje jednog ciljnog elementa u trenutku mjerenja. Povratna funkcija promatrača prima zapise asinkrono i može ih primiti više odjednom. entry.target je isti Element koji je proslijeđen metodi observe(), a ne root. Sva tri svojstva služe samo za čitanje, no sam element i dalje možeš mijenjati. To je API web-platforme, a ne dio ECMAScripta 2024.

entry.isIntersecting je logička vrijednost koja pokazuje siječe li ciljni element referentno područje promatrača pri tom mjerenju. Uz zadanu postavku root: null referentno je područje područje prikaza dokumenta najviše razine, a ne područje prikaza okvira iframe u kojem se nalazi cilj. Područje prikaza okvira ipak može ograničiti izračunani presjek. true opisuje stanje, ne nužno prijelaz u to stanje. Prema specifikaciji se i sam dodir rubova može računati kao presjek, čak i kad je površina presjeka nula.

entry.intersectionRatio je broj od 0 do 1: površina intersectionRect podijeljena površinom boundingClientRect ciljnog elementa, a ne površinom referentnog područja. Ako pravokutnik cilja ima površinu nula, rezultat je 1 kada je isIntersecting jednak true, a inače 0. Zadano je mjerenje geometrijsko i ne dokazuje da drugi element ne prekriva cilj.

Nakon poziva observe() dobit ćeš početni zapis čak i kad je cilj izvan referentnog područja. Novi zapisi mogu nastati pri prelasku praga u bilo kojem smjeru ili pri promjeni isIntersecting. Nećeš dobiti zapis za svaku promjenu omjera. threshold: 0.5 postavlja prag obavijesti, dok entry.intersectionRatio >= 0.5 provjerava vrijednost u pojedinom zapisu.

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

Rezultat

true 0.5 true
false 0 true

Spremi primjer kao HTML datoteku i otvori ga na zasebnoj kartici preglednika koji podržava taj API. Otvori razvojnu konzolu i ponovno učitaj stranicu. Prvi zapis pokazuje da presjek zauzima polovicu površine ciljnog elementa. Kôd pomiče cilj potpuno izvan referentnog područja, a drugi zapis pokazuje da presjeka više nema. Oba se zapisa odnose na isti element. Nakon drugog kôd zaustavlja promatranje i uklanja referentno područje.

Povezane lekcije

  • JavaScript · Lekcija 37 · Napredno · Verzija: 4

Izvori