CKTIS / JavaScript
IntersectionObserverEntry: isIntersecting, intersectionRatio in target
Ugotovi, kateri element se opazuje, ali seka referenčno območje in kolikšen je delež preseka. Loči stanje preseka od prehoda čez prag.
Različica: Current web platform; runtime support varies
Sintaksa
entry.isIntersecting // boolean
entry.intersectionRatio // number in [0, 1]
entry.target // ElementIntersectionObserverEntry zabeleži stanje enega ciljnega elementa v trenutku meritve. Povratna funkcija opazovalca prejema zapise asinhrono in jih lahko prejme več naenkrat. entry.target je isti Element, ki je bil posredovan metodi observe(), ne root. Vse tri lastnosti so samo za branje, sam element pa lahko še vedno spreminjaš. To je API spletne platforme in ni del ECMAScript 2024.
entry.isIntersecting je logična vrednost, ki pove, ali ciljni element pri meritvi seka referenčno območje opazovalca. Pri privzeti nastavitvi root: null je to vidno polje dokumenta na najvišji ravni, ne pa vidno polje okvirja iframe, v katerem je cilj. Vidno polje okvirja lahko kljub temu omeji izračunani presek. true opisuje stanje, ne nujno prehoda v to stanje. Po specifikaciji lahko kot presek šteje tudi sam stik robov, čeprav je ploščina preseka nič.
entry.intersectionRatio je število od 0 do 1: ploščina intersectionRect, deljena s ploščino boundingClientRect cilja, ne s ploščino referenčnega območja. Če ima pravokotnik cilja ploščino nič, je rezultat 1, kadar je isIntersecting enak true, sicer 0. Privzeta meritev je geometrijska in ne dokazuje, da cilja ne prekriva drug element.
Po klicu observe() prejmeš začetni zapis tudi takrat, ko je ciljni element zunaj referenčnega območja. Poznejši zapisi lahko nastanejo ob prehodu čez prag v katerikoli smeri ali ob spremembi isIntersecting. Vsaka sprememba razmerja ne ustvari zapisa. threshold: 0.5 določa prag za obvestila, entry.intersectionRatio >= 0.5 pa preveri vrednost konkretnega zapisa.
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: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>Rezultat
true 0.5 true false 0 true
Shrani primer kot datoteko HTML in ga odpri v samostojnem zavihku brskalnika, ki podpira ta API. Odpri razvijalsko konzolo in znova naloži stran. Prvi zapis kaže, da presek obsega polovico ploščine ciljnega elementa. Koda premakne element povsem iz referenčnega območja, drugi zapis pa pokaže, da preseka ni več. Oba zapisa se nanašata na isti element. Po drugem koda ustavi opazovanje in odstrani referenčno območje.
Povezane lekcije
- JavaScript · Lekcija 37 · Napredna · Različica: 4
Viri
- 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