CKTIS / JavaScript
IntersectionObserverEntry — odczytywanie przecięcia elementu
IntersectionObserverEntry opisuje przecięcie obserwowanego elementu z obszarem root w zapisanej chwili. Właściwości isIntersecting, target i intersectionRatio pozwalają sprawdzić stan przecięcia, rozpoznać element i odczytać udział jego przecinającej się powierzchni.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
entry.isIntersecting
entry.target
entry.intersectionRatioIntersectionObserverEntry to migawka geometrii, a nie stale aktualizowany obiekt. Przeglądarka przekazuje wpisy asynchronicznie do funkcji zwrotnej IntersectionObserver; oczekujące wpisy można też pobrać przez takeRecords(). Funkcja powinna obsługiwać całą tablicę entries, nie tylko pierwszy wpis.
IntersectionObserverEntry.target wskazuje obserwowany Element. IntersectionObserverEntry.isIntersecting jest wartością logiczną określającą przecięcie z obszarem root. IntersectionObserverEntry.intersectionRatio to liczba od 0 do 1: pole intersectionRect podzielone przez pole boundingClientRect. Dla elementu o zerowym polu wynosi 1, gdy isIntersecting jest true, a w przeciwnym razie 0; nie utożsamiaj tych dwóch właściwości.
Pierwsze powiadomienie opisuje stan początkowy po observe(). Kolejne zależą między innymi od przekroczenia skonfigurowanych progów threshold; nie jest to raport każdego piksela przewijania. Aby reagować na połowę powierzchni, uwzględnij próg 0.5 i sprawdzaj entry.isIntersecting && entry.intersectionRatio >= 0.5. Zwykła obserwacja geometrii nie dowodzi, że element nie jest zasłonięty innym elementem.
To przeglądarkowe Web API, nie funkcja konkretnej edycji ECMAScript. MDN oznacza podstawowy interfejs jako szeroko dostępny od marca 2019; dodatkowe funkcje mogą mieć inne wsparcie. Obecność Node 24 w repozytorium nie potwierdza dostępności tego API. Przykład umieszcza element o wysokości 100px w przycinającym obszarze root o wysokości 50px, a następnie kończy obserwację.
Przykłady
(() => {
const root = document.createElement('div');
root.style.cssText = 'all:initial;position:fixed;top:0;left:0;width:100px;height:50px;overflow:hidden;';
const target = document.createElement('div');
target.style.cssText = 'all:initial;display:block;width:100px;height:100px;';
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
for (const entry of entries) {
console.log(
entry.isIntersecting,
entry.target === target,
entry.intersectionRatio.toFixed(2)
);
}
observer.disconnect();
root.remove();
}, { root, threshold: [0, 0.5, 1] });
observer.observe(target);
})();Wynik
true true 0.50
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- IntersectionObserverEntry - Web APIs | MDN
- IntersectionObserverEntry: isIntersecting property - Web APIs | MDN
- IntersectionObserverEntry: target property - Web APIs | MDN
- IntersectionObserverEntry: intersectionRatio property - Web APIs | MDN
- Intersection Observer API - Web APIs | MDN
- IntersectionObserver: IntersectionObserver() constructor - Web APIs | MDN
- IntersectionObserver: observe() method - Web APIs | MDN