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 или проценти и разпределени както при CSSmargin: горе, вдясно, долу, вляво. Според спецификацията при анализ на низа абсолютните дължини, например тези в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
Източници
- IntersectionObserver: IntersectionObserver() constructor
- Intersection Observer API
- IntersectionObserver: rootMargin property
- Intersection Observer specification — Parse a margin
- IntersectionObserver: thresholds property
- IntersectionObserver: observe() method
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserver: disconnect() method
- HTML Standard — Update the rendering