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.intersectionRatioIntersectionObserverEntry 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
- 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