CKTIS / JavaScript
IntersectionObserverEntry: isIntersecting, intersectionRatio a target
Zjisti stav průniku, podíl plochy průniku a pozorovaný prvek. Rozlišuj stav průniku od překročení prahové hodnoty.
Verze: Current web platform; runtime support varies
Syntaxe
entry.isIntersecting // boolean
entry.intersectionRatio // number in [0, 1]
entry.target // ElementIntersectionObserverEntry zachycuje stav jednoho cíle v okamžiku měření. Zpětné volání pozorovatele dostává záznamy asynchronně a může jich dostat několik najednou. entry.target je tentýž objekt Element, který byl předán do observe(), nikoli root. Všechny tři vlastnosti jsou jen pro čtení, ale samotný prvek lze dál měnit. Jde o API webové platformy, nikoli součást ECMAScript 2024.
entry.isIntersecting je logická hodnota určující, zda se cíl při měření protíná s referenční oblastí pozorovatele. Při výchozím nastavení root: null je referenční oblastí zobrazovací oblast dokumentu nejvyšší úrovně, nikoli zobrazovací oblast rámce iframe, ve kterém se cíl nachází. Zobrazovací oblast rámce však může vypočtený průnik omezit. true popisuje stav, ne nutně přechod do něj. Podle specifikace se za průnik může počítat i pouhý dotyk hran s nulovou plochou průniku.
entry.intersectionRatio je číslo od 0 do 1: plocha intersectionRect dělená plochou boundingClientRect cíle, nikoli plochou referenční oblasti. Má-li obdélník cíle nulovou plochu, je výsledkem 1, pokud je isIntersecting rovno true, jinak 0. Výchozí měření je geometrické; nedokazuje, že cíl nezakrývá jiný prvek.
Po volání observe() dostaneš první záznam, i když je cíl mimo referenční oblast. Další záznamy mohou vzniknout při překročení prahu v libovolném směru nebo při změně isIntersecting. Záznam nedostaneš při každé změně poměru. threshold: 0.5 nastavuje práh pro oznámení, zatímco entry.intersectionRatio >= 0.5 testuje hodnotu konkrétního záznamu.
Pří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:relative;overflow:hidden;width:100px;height:100px';
const target = document.createElement('div');
target.style.cssText = 'position:absolute;left:0;top:50px;width:100px;height:100px;background:royalblue';
root.append(target);
document.body.append(root);
let moved = false;
const observer = new IntersectionObserver((entries) => {
for (const entry of entries) {
console.log(`${entry.isIntersecting} ${entry.intersectionRatio} ${entry.target === target}`);
if (!moved) {
moved = true;
target.style.top = '150px';
} else {
observer.disconnect();
root.remove();
}
}
}, { root, threshold: 0.5 });
observer.observe(target);
})();
</script>
</body>
</html>Výsledek
true 0.5 true false 0 true
Ulož příklad jako soubor HTML a otevři ho na samostatné kartě v prohlížeči, který toto API podporuje. Otevři vývojářskou konzoli a znovu načti stránku. První záznam ukazuje, že průnik zabírá polovinu plochy cíle. Kód přesune cíl zcela mimo referenční oblast a druhý záznam ukáže, že už k průniku nedochází. Oba záznamy odkazují na stejný prvek. Po druhém kód ukončí pozorování a odstraní referenční oblast.
Související lekce
- JavaScript · Lekce 37 · Pokročilá · Verze: 4
Zdroje
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserverEntry: target property
- IntersectionObserver: observe() method
- IntersectionObserver: IntersectionObserver() constructor
- HTML Standard — Web application APIs
- Intersection Observer specification — intersection geometry