CKTIS / JavaScript
IntersectionObserverEntry — čítanie prieniku prvku
IntersectionObserverEntry opisuje prienik pozorovaného prvku s koreňovou oblasťou v zaznamenanom okamihu. Vlastnosti isIntersecting, target a intersectionRatio určujú stav prieniku, príslušný prvok a podiel jeho plochy, ktorý sa prekrýva.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
entry.isIntersecting
entry.target
entry.intersectionRatioIntersectionObserverEntry je geometrická snímka, nie priebežne aktualizovaný objekt. Prehliadač odovzdáva záznamy asynchrónne do callbacku IntersectionObserver; čakajúce záznamy možno získať aj pomocou takeRecords(). Callback by mal spracovať celé pole entries, nielen jeho prvý záznam.
IntersectionObserverEntry.target odkazuje na pozorovaný Element. IntersectionObserverEntry.isIntersecting je logická hodnota určujúca, či dochádza k prieniku s koreňovou oblasťou. IntersectionObserverEntry.intersectionRatio je číslo od 0 do 1: plocha intersectionRect vydelená plochou boundingClientRect. Pri cieli s nulovou plochou má hodnotu 1, keď je isIntersecting true, a inak 0; nepovažujte tieto dve vlastnosti za rovnocenné.
Prvé oznámenie opisuje počiatočný stav po zavolaní observe(). Ďalšie oznámenia závisia okrem iného od prekročenia nastavených hodnôt threshold; nejde o hlásenie každého posunutého pixela pri posúvaní stránky. Ak chcete reagovať, keď sa pretína polovica plochy, zahrňte prah 0.5 a overte entry.isIntersecting && entry.intersectionRatio >= 0.5. Bežné geometrické pozorovanie nedokazuje, že cieľ nezakrýva iný prvok.
Ide o webové API prehliadača, nie o funkciu konkrétnej edície ECMAScriptu. MDN uvádza, že základné rozhranie je široko dostupné od marca 2019; ďalšie funkcie môžu mať inú mieru podpory. Prítomnosť Node 24 v repozitári nedokladá dostupnosť tohto API. Príklad umiestni cieľ vysoký 100px do orezávajúcej koreňovej oblasti vysokej 50px a potom pozorovanie ukončí.
Príklady
(() => {
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);
})();Výsledok
true true 0.50
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
Zdroje
- 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