CKTIS / JavaScript
IntersectionObserverEntry: състояние на пресичане и наблюдаван елемент
`isIntersecting` показва дали елементът пресича референтната област в момента на измерването, а `target` посочва за кой наблюдаван елемент се отнася записът.
Версия: Current web platform; runtime support varies
Синтаксис
entry.isIntersecting // boolean
entry.target // ElementСред свойствата само за четене на екземпляра на IntersectionObserverEntry са entry.isIntersecting и entry.target. entry.isIntersecting е булева стойност (true, ако елементът пресича референтната област, и false в противен случай). entry.target е същият DOM обект от тип Element, подаден на observe(), а не коренът или селектор. Референтната област може например да се определя от контейнер с превъртане. Когато root има стойността по подразбиране null, референтната област е видимата област (viewport) на документа от най-горно ниво. За елемент в iframe при изчисляването на intersectionRect се взема предвид и изрязването до границите на видимата област на рамката.
Записът отразява измерване и не се обновява в реално време. След observe() първото известие пристига асинхронно, дори елементът да не се е преместил. Следващите записи могат да съобщят за промяна в състоянието на пресичане или преминаване през зададен праг на относителния дял на пресичането. Само по себе си true не означава, че елементът току-що е навлязъл в областта. Обработи целия масив entries: едно извикване на обратната функция може да предостави няколко записа.
Допирът по ръбовете може да се брои за пресичане дори когато intersectionRatio е 0. За да провериш дали геометричното сечение има положителна площ, провери и двете условия: entry.intersectionRect.width > 0 и entry.intersectionRect.height > 0. Това не доказва, че потребителят вижда елемента: друг елемент може да го закрива.
Този API е част от уеб платформата, а не от ECMAScript 2024. Провери дали целевата среда предоставя IntersectionObserver. Използвай unobserve(element), за да спреш наблюдението на един елемент, или disconnect(), за да спреш наблюдението на всички елементи на този наблюдател.
Примери
<!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>Резултат
inside: true outside: false
Запази кода като HTML файл, отвори го в браузър и провери резултата в конзолата за разработчици. Първият елемент е вътре в референтния контейнер, а вторият е изцяло извън него. Кодът изчаква и двата начални записа, отпечатва състоянията в определен ред и след това почиства използваните ресурси.
Свързани уроци
- JavaScript · Урок 30 · Средно · Версия: 3
Източници
- 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