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

CKTIS / JavaScript

Опции на IntersectionObserver: root, rootMargin и threshold

`root` избира референтната област, `rootMargin` измества границите ѝ за целите на изчислението, а `threshold` задава при какви дялове от площта на целта се изпращат известия.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: [0, 0.5, 1] })

IntersectionObserver е браузърен API, а не част от ECMAScript. root избира референтната област: ако пропуснеш опцията или подадеш null, се използва видимата област на документа от най-горно ниво. Можеш изрично да посочиш Document или Element, например контейнер с превъртане. Ако коренът е елемент, целта трябва да е негов потомък във веригата от съдържащи блокове на оформлението.

rootMargin е низ с една до четири стойности, зададени като абсолютни дължини в CSS или проценти и разпределени както при CSS margin: горе, вдясно, долу, вляво. Според спецификацията при анализ на низа абсолютните дължини, например тези в cm, се преобразуват в пиксели. За съвместимост между браузърите използвай px или %, тъй като някои браузъри отхвърлят други абсолютни единици. По подразбиране всяка страна има стойност 0px. Процентите се изчисляват спрямо ширината на първоначалния правоъгълник на корена, включително горе и долу. Положителните стойности разширяват правоъгълника за изчислението, а отрицателните го свиват. Това не променя оформлението и не отменя изрязването от междинни предшественици. За цели от друг произход отстъпът се пренебрегва, а entry.rootBounds е null.

threshold приема число или масив от числа от 0 до 1 включително. Ако пропуснеш опцията или подадеш празен масив, прагът е 0. Опцията на конструктора е threshold, а свойството само за четене observer.thresholds връща числово сортиран масив във възходящ ред. Праг извън диапазона предизвиква RangeError, а невалиден rootMargin предизвиква DOMException с име SyntaxError.

След observe(target) функцията за обратно извикване получава асинхронно начален запис дори когато няма пресичане. Следващи записи се поставят на опашката при преминаване на праг в която и да е посока или при промяна на entry.isIntersecting, а не при всяка промяна на отношението. 0.5 означава половината от площта на ограждащия правоъгълник на целта, а не на корена. Допир на ръбовете може да даде isIntersecting: true при intersectionRatio: 0. Ако правоъгълникът на целта има нулева площ, отношението е 1, когато isIntersecting е истина, и 0 в противен случай. Геометричното пресичане не доказва, че потребителят вижда целта.

Опциите се фиксират при създаването на наблюдателя. За да ги промениш, създай нов наблюдател. Използвай unobserve(target), за да спреш наблюдението на една цел, или disconnect(), за да спреш наблюдението на всички цели. Провери дали средата, в която ще се изпълнява кодът, поддържа API.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IntersectionObserver options</title>
</head>
<body>
<script>
{
  const root = document.createElement("div");
  const spacer = document.createElement("div");
  const target = document.createElement("div");
  root.style.cssText = "width: 120px; height: 100px; overflow: hidden";
  spacer.style.height = "120px";
  target.style.cssText = "height: 40px; background: teal";
  root.append(spacer, target);
  document.body.append(root);

  const observer = new IntersectionObserver(([entry], observer) => {
    console.log(`root matches: ${observer.root === root}`);
    console.log(`rootMargin: ${observer.rootMargin}`);
    console.log(`thresholds: ${JSON.stringify(observer.thresholds)}`);
    console.log(`isIntersecting: ${entry.isIntersecting}`);
    console.log(`intersectionRatio: ${entry.intersectionRatio}`);
    observer.disconnect();
    root.remove();
  }, {
    root,
    rootMargin: "0px 0px 40px",
    threshold: [1, 0, 0.5],
  });
  observer.observe(target);
}
</script>
</body>
</html>

Резултат

root matches: true
rootMargin: 0px 0px 40px 0px
thresholds: [0,0.5,1]
isIntersecting: true
intersectionRatio: 0.5

Запази примера като HTML файл, отвори го в активен раздел на браузъра и провери изхода в конзолата за разработчици. Целта започва 20 px под долния ръб на корена. Долният отстъп от 40 px обхваща половината от височината на целта по цялата ѝ ширина. Затова началният запис показва `intersectionRatio: 0.5`. Кодът прекратява наблюдението и премахва демонстрационните елементи.

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

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

Източници