CKTIS / JavaScript
IntersectionObserver: наблюдение на пресичанията на елементи
IntersectionObserver асинхронно съобщава за геометричното пресичане между елемент и референтна област. Научете за опциите root, rootMargin и threshold и разграничете пресичането от действителната видимост.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })IntersectionObserver е уеб API на браузъра, а не функция на ECMAScript. Наличието му в Node 24 не доказва поддръжка в браузъра; проверете целевата среда.
root задава референтната област; стойността по подразбиране null означава изгледа. rootMargin разширява или свива границите ѝ с 1–4 стойности в пиксели или проценти. Тези отмествания се прилагат само за целеви елементи от същия домейн на произход (same-origin-domain) и се пренебрегват за целеви елементи от друг домейн на произход (cross-origin-domain). threshold приема число или масив в диапазона [0, 1], като стойността по подразбиране е 0. Свойството thresholds, достъпно само за четене, показва сортираните съотношения на площта на целевия елемент.
След началото на наблюдението обратното извикване обикновено получава първоначален запис за целевия елемент, но това не е гарантирано. Наблюдението може да спре, преди записът да бъде създаден, а takeRecords() може да го извади от опашката, преди да бъде предаден на обратното извикване. Следващите записи се добавят в опашката при преминаване на праг или промяна на isIntersecting. Геометричното пресичане не доказва действителна видимост; допиращи се ръбове могат да доведат до isIntersecting === true при нулева площ на пресичане.
observe(target) започва наблюдението, unobserve(target) го спира за един целеви елемент, а disconnect() — за всички. Примерът проверява първоначалното пълно пресичане и след това освобождава ресурсите.
Примери
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver unavailable");
}
const root = document.createElement("div");
root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
const target = document.createElement("div");
target.style.cssText = "width:20px;height:20px;margin:0;";
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
console.log(entries[0].intersectionRatio === 1);
observer.disconnect();
root.remove();
}, { root, rootMargin: "0px", threshold: [0, 1] });
observer.observe(target);
})();Резултат
true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.