Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IntersectionObserverEntry — čitanje presjeka elementa

IntersectionObserverEntry opisuje presjek promatranog elementa s korijenskim područjem u zabilježenom trenutku. Svojstva isIntersecting, target i intersectionRatio određuju stanje presjeka, element i udio njegove površine koji se presijeca.

Verzija: 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 geometrijska je snimka, a ne objekt koji se stalno ažurira. Preglednik asinkrono predaje zapise povratnoj funkciji IntersectionObserver; zapise na čekanju moguće je dohvatiti i pomoću takeRecords(). Povratna funkcija trebala bi obraditi cijeli niz entries, a ne samo prvi zapis.

IntersectionObserverEntry.target upućuje na promatrani Element. IntersectionObserverEntry.isIntersecting logička je vrijednost koja pokazuje postoji li presjek s korijenskim područjem. IntersectionObserverEntry.intersectionRatio broj je od 0 do 1: površina intersectionRect podijeljena površinom boundingClientRect. Za cilj površine nula vrijednost je 1 kada je isIntersecting true, a inače 0; nemoj ove dvije značajke smatrati istovjetnima.

Prva obavijest opisuje početno stanje nakon observe(). Kasnije obavijesti ovise, među ostalim, o prelasku konfiguriranih vrijednosti threshold; ne prikazuju svaki piksel pomicanja. Za reakciju kada se presijeca polovica površine uključi prag 0.5 i provjeri entry.isIntersecting && entry.intersectionRatio >= 0.5. Uobičajeno geometrijsko promatranje ne dokazuje da neki drugi element ne prekriva cilj.

Ovo je web-API preglednika, a ne značajka određenog izdanja ECMAScripta. MDN navodi da je osnovno sučelje široko dostupno od ožujka 2019.; dodatne značajke mogu imati drukčiju podršku. Prisutnost Node 24 u repozitoriju ne potvrđuje dostupnost API-ja. Primjer smješta cilj visine 100px unutar korijenskog područja za obrezivanje visine 50px, a zatim zaustavlja promatranje.

Primjeri

(() => {
  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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori