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.intersectionRatioIntersectionObserverEntry 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
- IntersectionObserverEntry - Web APIs | MDN
- IntersectionObserverEntry: isIntersecting property - Web APIs | MDN
- IntersectionObserverEntry: target property - Web APIs | MDN
- IntersectionObserverEntry: intersectionRatio property - Web APIs | MDN
- Intersection Observer API - Web APIs | MDN
- IntersectionObserver: IntersectionObserver() constructor - Web APIs | MDN
- IntersectionObserver: observe() method - Web APIs | MDN