Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

IntersectionObserverEntry: stan przecięcia i obserwowany element

`isIntersecting` określa, czy element przecina obszar odniesienia w chwili pomiaru, a `target` wskazuje, którego obserwowanego elementu dotyczy wpis.

Wersja: Current web platform; runtime support varies

Składnia

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

Do właściwości instancji IntersectionObserverEntry dostępnych tylko do odczytu należą entry.isIntersecting i entry.target. entry.isIntersecting to wartość logiczna (true, gdy element przecina obszar odniesienia, false w przeciwnym razie), a entry.target to ten sam obiekt DOM typu Element, który przekazano do observe(). target nie jest ani obszarem odniesienia, ani selektorem. Obszar odniesienia może wyznaczać np. kontener przewijania. Gdy root ma domyślną wartość null, obszarem odniesienia jest obszar widoku dokumentu najwyższego poziomu. W przypadku elementu w ramce iframe przy obliczaniu intersectionRect uwzględnia się także przycięcie do obszaru widoku ramki.

Wpis opisuje stan w chwili pomiaru, a nie stan aktualizowany na bieżąco. Po observe() raport początkowy przychodzi asynchronicznie, nawet jeśli element się nie poruszył. Późniejsze wpisy mogą wynikać ze zmiany stanu przecięcia lub przekroczenia skonfigurowanego progu proporcji. Samo true nie oznacza więc, że element właśnie znalazł się w obszarze odniesienia. Przetwarzaj całą tablicę entries: jedno wywołanie funkcji zwrotnej może dostarczyć kilka wpisów.

Samo zetknięcie krawędzi może dać true przy intersectionRatio równym 0. Aby sprawdzić, czy geometryczne przecięcie ma dodatnie pole, sprawdź, czy entry.intersectionRect.width > 0 i entry.intersectionRect.height > 0. Nie świadczy to o tym, że użytkownik widzi element: może go zasłaniać inny element.

To interfejs API platformy WWW, a nie część ECMAScript 2024. Sprawdź, czy docelowe środowisko udostępnia IntersectionObserver. Wywołaj unobserve(element), aby przestać obserwować jeden element, lub disconnect(), aby przestać obserwować wszystkie elementy tego obserwatora.

Przykłady

<!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>

Wynik

inside: true
outside: false

Zapisz kod jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Pierwszy element mieści się w kontenerze odniesienia, a drugi leży całkowicie poza nim. Kod czeka na oba wpisy początkowe, wypisuje wyniki w stałej kolejności i sprząta po sobie.

Powiązane lekcje

  • JavaScript · Lekcja 30 · Średniozaawansowany · Wersja: 3

Źródła