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

CKTIS / JavaScript

IntersectionObserverEntry: състояние на пресичане и наблюдаван елемент

`isIntersecting` показва дали елементът пресича референтната област в момента на измерването, а `target` посочва за кой наблюдаван елемент се отнася записът.

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

Синтаксис

entry.isIntersecting // boolean
entry.target         // Element

Сред свойствата само за четене на екземпляра на IntersectionObserverEntry са entry.isIntersecting и entry.target. entry.isIntersecting е булева стойност (true, ако елементът пресича референтната област, и false в противен случай). entry.target е същият DOM обект от тип Element, подаден на observe(), а не коренът или селектор. Референтната област може например да се определя от контейнер с превъртане. Когато root има стойността по подразбиране null, референтната област е видимата област (viewport) на документа от най-горно ниво. За елемент в iframe при изчисляването на intersectionRect се взема предвид и изрязването до границите на видимата област на рамката.

Записът отразява измерване и не се обновява в реално време. След observe() първото известие пристига асинхронно, дори елементът да не се е преместил. Следващите записи могат да съобщят за промяна в състоянието на пресичане или преминаване през зададен праг на относителния дял на пресичането. Само по себе си true не означава, че елементът току-що е навлязъл в областта. Обработи целия масив entries: едно извикване на обратната функция може да предостави няколко записа.

Допирът по ръбовете може да се брои за пресичане дори когато intersectionRatio е 0. За да провериш дали геометричното сечение има положителна площ, провери и двете условия: entry.intersectionRect.width > 0 и entry.intersectionRect.height > 0. Това не доказва, че потребителят вижда елемента: друг елемент може да го закрива.

Този API е част от уеб платформата, а не от ECMAScript 2024. Провери дали целевата среда предоставя IntersectionObserver. Използвай unobserve(element), за да спреш наблюдението на един елемент, или disconnect(), за да спреш наблюдението на всички елементи на този наблюдател.

Примери

<!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:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';

  const makeTarget = (left) => {
    const element = document.createElement('div');
    element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
    root.append(element);
    return element;
  };

  const inside = makeTarget(8);
  const outside = makeTarget(150);
  document.body.append(root);

  const states = new Map();
  const observer = new IntersectionObserver((entries, currentObserver) => {
    for (const entry of entries) {
      states.set(entry.target, entry.isIntersecting);
    }
    if (!states.has(inside) || !states.has(outside)) return;

    currentObserver.disconnect();
    root.remove();
    console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
  }, { root });

  observer.observe(inside);
  observer.observe(outside);
})();
</script>
</body>
</html>

Резултат

inside: true
outside: false

Запази кода като HTML файл, отвори го в браузър и провери резултата в конзолата за разработчици. Първият елемент е вътре в референтния контейнер, а вторият е изцяло извън него. Кодът изчаква и двата начални записа, отпечатва състоянията в определен ред и след това почиства използваните ресурси.

Свързани уроци

  • JavaScript · Урок 30 · Средно · Версия: 3

Източници