CKTIS / JavaScript
IntersectionObserverEntry: stav prieniku a sledovaný prvok
`isIntersecting` udáva, či sa prvok v okamihu merania pretína s referenčnou oblasťou. `target` určuje, ku ktorému sledovanému prvku sa záznam vzťahuje.
Verzia: Current web platform; runtime support varies
Syntax
entry.isIntersecting // boolean
entry.target // ElementMedzi inštančné vlastnosti IntersectionObserverEntry určené iba na čítanie patria entry.isIntersecting a entry.target. entry.isIntersecting je logická hodnota (true, ak sa prvok pretína s referenčnou oblasťou, inak false). entry.target je ten istý objekt DOM typu Element, ktorý bol odovzdaný metóde observe(), nie koreň ani selektor. Referenčnú oblasť môže určovať napríklad posúvateľný kontajner. Ak má root predvolenú hodnotu null, referenčnou oblasťou je zobrazovacia oblasť (viewport) dokumentu najvyššej úrovne. Pri prvku vnútri iframe sa pri výpočte intersectionRect zohľadňuje aj orezanie na zobrazovaciu oblasť rámca.
Záznam zachytáva meranie a priebežne sa neaktualizuje. Po observe() príde prvé hlásenie asynchrónne, aj keď sa prvok nepohol. Ďalšie záznamy môžu hlásiť zmenu stavu prieniku alebo prekročenie nastaveného prahu pomeru prieniku. Samotné true teda neznamená, že prvok práve vstúpil do oblasti. Spracuj celé pole entries: jediné volanie spätnej funkcie môže priniesť viac záznamov.
Dotyk hrán sa môže počítať ako prienik, aj keď sa intersectionRatio rovná 0. Ak chceš overiť, že geometrický prienik má kladnú plochu, skontroluj, či platí entry.intersectionRect.width > 0 aj entry.intersectionRect.height > 0. To ešte nedokazuje, že používateľ prvok vidí: môže ho zakrývať iný prvok.
Toto API patrí k webovej platforme, nie k ECMAScript 2024. Over, či cieľové prostredie poskytuje IntersectionObserver. Použi unobserve(element) na ukončenie sledovania jedného prvku alebo disconnect() na ukončenie sledovania všetkých prvkov daného pozorovateľa.
Príklady
<!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>Výsledok
inside: true outside: false
Ulož kód ako súbor HTML, otvor ho v prehliadači a skontroluj výstup vo vývojárskej konzole. Prvý prvok je vnútri referenčného kontajnera, druhý je celý mimo neho. Kód počká na oba počiatočné záznamy, vypíše stavy v pevnom poradí a potom po sebe uprace.
Súvisiace lekcie
- JavaScript · Lekcia 30 · Stredne pokročilá · Verzia: 3
Zdroje
- 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