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

CKTIS / JavaScript

IntersectionObserverEntry: isIntersecting, intersectionRatio и target

Провери кой е наблюдаваният елемент, дали пресича референтната област и каква част от площта му попада в сечението. Разграничи състоянието от преминаването на праг.

Версия: Current web platform; runtime support varies

Синтаксис

entry.isIntersecting     // boolean
entry.intersectionRatio // number in [0, 1]
entry.target            // Element

IntersectionObserverEntry записва състоянието на един целеви елемент в момента на измерването. Обратното извикване на наблюдателя получава записите асинхронно и може да получи няколко наведнъж. 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

Източници