Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.intersectionRatio

IntersectionObserverEntry 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