CKTIS / JavaScript
IntersectionObserverEntry: isIntersecting, intersectionRatio и target
Провери кой е наблюдаваният елемент, дали пресича референтната област и каква част от площта му попада в сечението. Разграничи състоянието от преминаването на праг.
Версия: Current web platform; runtime support varies
Синтаксис
entry.isIntersecting // boolean
entry.intersectionRatio // number in [0, 1]
entry.target // ElementIntersectionObserverEntry записва състоянието на един целеви елемент в момента на измерването. Обратното извикване на наблюдателя получава записите асинхронно и може да получи няколко наведнъж. entry.target е същият Element, подаден на observe(), а не root. И трите свойства са само за четене, но самият елемент може да се променя. Това е API на уеб платформата, а не част от ECMAScript 2024.
entry.isIntersecting е булева стойност, която показва дали при измерването целевият елемент пресича референтната област на наблюдателя. При настройката по подразбиране root: null това е видимата област на документа от най-горно ниво, а не видимата област на рамката iframe, в която се намира целта. Видимата област на рамката обаче може да ограничи изчисленото сечение. true описва състояние, а не непременно преход към него. Според спецификацията дори допирът на ръбовете може да се счита за пресичане, въпреки че площта на сечението е нула.
entry.intersectionRatio е число от 0 до 1: площта на intersectionRect, разделена на площта на boundingClientRect на целевия елемент, а не на площта на референтната област. Ако правоъгълникът на целевия елемент има нулева площ, резултатът е 1, когато isIntersecting е true, и 0 в противен случай. Измерването по подразбиране е геометрично и не доказва, че друг елемент не закрива целевия елемент.
След извикване на observe() получаваш начален запис дори когато целевият елемент е извън референтната област. Следващи записи може да има при преминаване през праг в която и да е посока или при промяна на isIntersecting. Не всяка промяна на съотношението създава запис. threshold: 0.5 задава праг за известяване, докато entry.intersectionRatio >= 0.5 проверява стойността в конкретен запис.
Примери
<!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>Резултат
true 0.5 true false 0 true
Запази примера като HTML файл и го отвори в отделен раздел на браузър, който поддържа API. Отвори конзолата за разработчици и презареди страницата. Първият запис показва, че сечението заема половината от площта на целевия елемент. Кодът премества елемента изцяло извън референтната област, а вторият запис показва, че вече няма пресичане. И двата записа сочат към един и същ елемент. След втория кодът спира наблюдението и премахва референтната област.
Свързани уроци
- JavaScript · Урок 37 · Напреднало · Версия: 4
Източници
- 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