База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници