CKTIS / JavaScript
IntersectionObserverEntry: stanje preseka in opazovani element
`isIntersecting` pove, ali se element v trenutku meritve seka z referenčnim območjem. `target` določa, na kateri opazovani element se zapis nanaša.
Različica: Current web platform; runtime support varies
Sintaksa
entry.isIntersecting // boolean
entry.target // ElementMed lastnosti primerka IntersectionObserverEntry, ki so samo za branje, spadata entry.isIntersecting in entry.target. entry.isIntersecting je logična vrednost (true, če se element seka z referenčnim območjem, sicer false). entry.target je isti objekt DOM tipa Element, ki je bil podan metodi observe(), ne koren niti izbirnik. Referenčno območje lahko na primer določa vsebnik z drsenjem. Če ima root privzeto vrednost null, je referenčno območje prikazno območje (viewport) dokumenta na najvišji ravni. Pri elementu v iframe se pri izračunu intersectionRect upošteva tudi obrezovanje na meje prikaznega območja okvirja.
Zapis zajame meritev in se ne posodablja sproti. Po klicu observe() prvo obvestilo prispe asinhrono, tudi če se element ni premaknil. Poznejši zapisi lahko sporočijo spremembo stanja preseka ali prehod čez nastavljeni prag razmerja preseka. Sama vrednost true zato ne pomeni, da je element pravkar vstopil v območje. Obdelaj celotno polje entries: en klic povratne funkcije lahko dostavi več zapisov.
Stik robov lahko šteje za presek, tudi če je intersectionRatio enak 0. Če želiš preveriti, ali ima geometrijski presek pozitivno ploščino, preveri oba pogoja: entry.intersectionRect.width > 0 in entry.intersectionRect.height > 0. To še ne dokazuje, da uporabnik vidi element: lahko ga prekriva drug element.
Ta API pripada spletni platformi in ni del ECMAScript 2024. Preveri, ali ciljno izvajalno okolje ponuja IntersectionObserver. Z unobserve(element) prenehaš opazovati en element, z disconnect() pa vse elemente tega opazovalnika.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IntersectionObserverEntry example</title>
</head>
<body>
<script>
(() => {
const root = document.createElement('div');
root.style.cssText = 'position:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';
const makeTarget = (left) => {
const element = document.createElement('div');
element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
root.append(element);
return element;
};
const inside = makeTarget(8);
const outside = makeTarget(150);
document.body.append(root);
const states = new Map();
const observer = new IntersectionObserver((entries, currentObserver) => {
for (const entry of entries) {
states.set(entry.target, entry.isIntersecting);
}
if (!states.has(inside) || !states.has(outside)) return;
currentObserver.disconnect();
root.remove();
console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
}, { root });
observer.observe(inside);
observer.observe(outside);
})();
</script>
</body>
</html>Rezultat
inside: true outside: false
Shrani kodo kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Prvi element je v referenčnem vsebniku, drugi pa v celoti zunaj njega. Koda počaka na oba začetna zapisa, izpiše stanji v stalnem vrstnem redu in nato počisti za seboj.
Povezane lekcije
- JavaScript · Lekcija 30 · Srednja · Različica: 3
Viri
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserverEntry: target property
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserver: observe() method
- IntersectionObserver: IntersectionObserver() constructor
- Intersection Observer API
- HTML Standard — Event loops
- ECMAScript® 2024 Language Specification — Scope
- Intersection Observer specification