CKTIS / JavaScript
IntersectionObserverEntry — прочитане на пресичането на елемент
IntersectionObserverEntry описва пресичането на наблюдаван елемент с кореновата област в записан момент. Свойствата isIntersecting, target и intersectionRatio показват състоянието на пресичане, елемента и дела от площта му, който се пресича.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
entry.isIntersecting
entry.target
entry.intersectionRatioIntersectionObserverEntry е моментна геометрична снимка, а не обект, който се обновява непрекъснато. Браузърът предава записите асинхронно на callback функция на IntersectionObserver; чакащите записи могат да бъдат получени и чрез takeRecords(). Callback функцията трябва да обработва целия масив entries, а не само първия запис.
IntersectionObserverEntry.target препраща към наблюдавания Element. IntersectionObserverEntry.isIntersecting е булева стойност, която показва дали има пресичане с кореновата област. IntersectionObserverEntry.intersectionRatio е число от 0 до 1: площта на intersectionRect, разделена на площта на boundingClientRect. За цел с нулева площ стойността е 1, когато isIntersecting е true, и 0 в противен случай; не приемайте тези две свойства за равнозначни.
Първото известие описва началното състояние след observe(). Следващите известия зависят, наред с другото, от преминаването на зададените стойности threshold; това не е отчет за всеки изместен пиксел при превъртане. За реакция при пресичане на половината площ включете прага 0.5 и проверете entry.isIntersecting && entry.intersectionRatio >= 0.5. Обикновеното геометрично наблюдение не доказва, че друг елемент не закрива целта.
Това е браузърно Web API, а не функция на конкретно издание на ECMAScript. MDN отбелязва, че основният интерфейс е широко достъпен от март 2019 г.; допълнителните функции може да имат различна поддръжка. Наличието на Node 24 в хранилище не доказва, че API е наличен. Примерът поставя цел с височина 100px в коренова област за изрязване с височина 50px, след което спира наблюдението.
Примери
(() => {
const root = document.createElement('div');
root.style.cssText = 'all:initial;position:fixed;top:0;left:0;width:100px;height:50px;overflow:hidden;';
const target = document.createElement('div');
target.style.cssText = 'all:initial;display:block;width:100px;height:100px;';
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
for (const entry of entries) {
console.log(
entry.isIntersecting,
entry.target === target,
entry.intersectionRatio.toFixed(2)
);
}
observer.disconnect();
root.remove();
}, { root, threshold: [0, 0.5, 1] });
observer.observe(target);
})();Резултат
true true 0.50
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- IntersectionObserverEntry - Web APIs | MDN
- IntersectionObserverEntry: isIntersecting property - Web APIs | MDN
- IntersectionObserverEntry: target property - Web APIs | MDN
- IntersectionObserverEntry: intersectionRatio property - Web APIs | MDN
- Intersection Observer API - Web APIs | MDN
- IntersectionObserver: IntersectionObserver() constructor - Web APIs | MDN
- IntersectionObserver: observe() method - Web APIs | MDN