CKTIS / JavaScript
IntersectionObserverEntry: isIntersecting, intersectionRatio i target
Saznaj koji se element promatra, siječe li referentno područje i koliki je udio površine presjeka. Razlikuj stanje presjeka od prelaska praga.
Verzija: Current web platform; runtime support varies
Sintaksa
entry.isIntersecting // boolean
entry.intersectionRatio // number in [0, 1]
entry.target // ElementIntersectionObserverEntry bilježi stanje jednog ciljnog elementa u trenutku mjerenja. Povratna funkcija promatrača prima zapise asinkrono i može ih primiti više odjednom. entry.target je isti Element koji je proslijeđen metodi observe(), a ne root. Sva tri svojstva služe samo za čitanje, no sam element i dalje možeš mijenjati. To je API web-platforme, a ne dio ECMAScripta 2024.
entry.isIntersecting je logička vrijednost koja pokazuje siječe li ciljni element referentno područje promatrača pri tom mjerenju. Uz zadanu postavku root: null referentno je područje područje prikaza dokumenta najviše razine, a ne područje prikaza okvira iframe u kojem se nalazi cilj. Područje prikaza okvira ipak može ograničiti izračunani presjek. true opisuje stanje, ne nužno prijelaz u to stanje. Prema specifikaciji se i sam dodir rubova može računati kao presjek, čak i kad je površina presjeka nula.
entry.intersectionRatio je broj od 0 do 1: površina intersectionRect podijeljena površinom boundingClientRect ciljnog elementa, a ne površinom referentnog područja. Ako pravokutnik cilja ima površinu nula, rezultat je 1 kada je isIntersecting jednak true, a inače 0. Zadano je mjerenje geometrijsko i ne dokazuje da drugi element ne prekriva cilj.
Nakon poziva observe() dobit ćeš početni zapis čak i kad je cilj izvan referentnog područja. Novi zapisi mogu nastati pri prelasku praga u bilo kojem smjeru ili pri promjeni isIntersecting. Nećeš dobiti zapis za svaku promjenu omjera. threshold: 0.5 postavlja prag obavijesti, dok entry.intersectionRatio >= 0.5 provjerava vrijednost u pojedinom zapisu.
Primjeri
<!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
Spremi primjer kao HTML datoteku i otvori ga na zasebnoj kartici preglednika koji podržava taj API. Otvori razvojnu konzolu i ponovno učitaj stranicu. Prvi zapis pokazuje da presjek zauzima polovicu površine ciljnog elementa. Kôd pomiče cilj potpuno izvan referentnog područja, a drugi zapis pokazuje da presjeka više nema. Oba se zapisa odnose na isti element. Nakon drugog kôd zaustavlja promatranje i uklanja referentno područje.
Povezane lekcije
- JavaScript · Lekcija 37 · Napredno · Verzija: 4
Izvori
- 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