Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

IntersectionObserverEntry — branje preseka elementa

IntersectionObserverEntry opisuje presek opazovanega elementa s korenskim območjem v zabeleženem trenutku. Lastnosti isIntersecting, target in intersectionRatio povedo stanje preseka, kateri element je vključen in kolikšen delež njegove površine se prekriva.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

entry.isIntersecting
entry.target
entry.intersectionRatio

IntersectionObserverEntry je geometrijski posnetek, ne objekt, ki bi se sproti posodabljal. Brskalnik zapise asinhrono posreduje povratni funkciji IntersectionObserver; čakajoče zapise je mogoče pridobiti tudi z takeRecords(). Povratna funkcija naj obdela celotno polje entries, ne le prvega zapisa.

IntersectionObserverEntry.target se nanaša na opazovani Element. IntersectionObserverEntry.isIntersecting je logična vrednost, ki pove, ali se element prekriva s korenskim območjem. IntersectionObserverEntry.intersectionRatio je število od 0 do 1: površina intersectionRect, deljena s površino boundingClientRect. Pri cilju s površino nič je vrednost 1, kadar je isIntersecting true, sicer pa 0; teh dveh lastnosti ne obravnavaj kot enakovrednih.

Prvo obvestilo opisuje začetno stanje po observe(). Poznejša obvestila so med drugim odvisna od preseganja nastavljenih vrednosti threshold; ne poročajo o vsakem premaknjenem pikslu pri drsenju. Če se želiš odzvati, ko se prekriva polovica površine, vključi prag 0.5 in preveri entry.isIntersecting && entry.intersectionRatio >= 0.5. Običajno geometrijsko opazovanje ne dokazuje, da cilja ne prekriva drug element.

To je spletni API brskalnika, ne funkcija določene izdaje ECMAScripta. MDN navaja, da je osnovni vmesnik široko dostopen od marca 2019; dodatne funkcije so lahko podprte drugače. Prisotnost Node 24 v repozitoriju ne dokazuje, da je API na voljo. Primer postavi cilj višine 100px v korensko območje za izrezovanje višine 50px, nato pa ustavi opazovanje.

Primeri

(() => {
  const root = document.createElement('div');
  root.style.cssText = 'all:initial;position:fixed;top:0;left:0;width:100px;height:50px;overflow:hidden;';
  const target = document.createElement('div');
  target.style.cssText = 'all:initial;display:block;width:100px;height:100px;';
  root.append(target);
  document.body.append(root);

  const observer = new IntersectionObserver((entries) => {
    for (const entry of entries) {
      console.log(
        entry.isIntersecting,
        entry.target === target,
        entry.intersectionRatio.toFixed(2)
      );
    }
    observer.disconnect();
    root.remove();
  }, { root, threshold: [0, 0.5, 1] });

  observer.observe(target);
})();

Rezultat

true true 0.50

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri