Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

IntersectionObserverEntry: isIntersecting, intersectionRatio i target

Odczytaj stan przecięcia, udział pola przecięcia i obserwowany element. Naucz się odróżniać stan przecięcia od przekroczenia progu.

Wersja: Current web platform; runtime support varies

Składnia

entry.isIntersecting     // boolean
entry.intersectionRatio // number in [0, 1]
entry.target            // Element

IntersectionObserverEntry zapisuje stan jednego celu w chwili pomiaru. Funkcja zwrotna obserwatora otrzymuje wpisy asynchronicznie i może dostać ich kilka naraz. entry.target to ten sam obiekt Element, który przekazano do observe(), a nie root. Wszystkie trzy właściwości są tylko do odczytu, ale sam element nadal można modyfikować. Jest to API platformy webowej, a nie część ECMAScript 2024.

entry.isIntersecting to wartość logiczna określająca, czy w danym pomiarze cel przecina obszar odniesienia obserwatora (root). Przy domyślnym root: null obszarem odniesienia jest obszar widoku dokumentu najwyższego poziomu, a nie dokumentu wewnątrz ramki iframe, w której znajduje się cel. Obszar widoku ramki może jednak ograniczać obliczane przecięcie. true opisuje stan, niekoniecznie moment wejścia w obszar. Według specyfikacji może też oznaczać styk krawędzi przy zerowym polu przecięcia.

entry.intersectionRatio to liczba od 0 do 1: pole intersectionRect podzielone przez pole boundingClientRect celu, a nie przez pole obszaru odniesienia. Gdy pole prostokąta celu wynosi zero, wynik to 1, jeśli isIntersecting jest true, a w przeciwnym razie 0. Domyślny pomiar dotyczy geometrii; nie dowodzi, że inny element nie zasłania celu.

Po wywołaniu observe() otrzymasz wpis początkowy, nawet jeśli cel znajduje się poza obszarem odniesienia. Kolejne wpisy mogą wynikać z przekroczenia progu w dowolnym kierunku lub ze zmiany isIntersecting; nie otrzymasz wpisu dla każdej zmiany proporcji. threshold: 0.5 ustawia próg powiadomień, natomiast entry.intersectionRatio >= 0.5 sprawdza wartość w konkretnym wpisie.

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:relative;overflow:hidden;width:100px;height:100px';
  const target = document.createElement('div');
  target.style.cssText = 'position:absolute;left:0;top:50px;width:100px;height:100px;background:royalblue';
  root.append(target);
  document.body.append(root);

  let moved = false;
  const observer = new IntersectionObserver((entries) => {
    for (const entry of entries) {
      console.log(`${entry.isIntersecting} ${entry.intersectionRatio} ${entry.target === target}`);
      if (!moved) {
        moved = true;
        target.style.top = '150px';
      } else {
        observer.disconnect();
        root.remove();
      }
    }
  }, { root, threshold: 0.5 });
  observer.observe(target);
})();
</script>
</body>
</html>

Wynik

true 0.5 true
false 0 true

Zapisz przykład jako plik HTML i otwórz go w osobnej karcie przeglądarki obsługującej to API. Otwórz konsolę deweloperską i odśwież stronę. Pierwszy wpis pokazuje przecięcie obejmujące połowę pola celu. Kod przesuwa cel całkowicie poza obszar odniesienia, a drugi wpis pokazuje brak przecięcia. Oba wpisy wskazują ten sam element; po drugim kod kończy obserwację i usuwa obszar odniesienia.

Powiązane lekcje

  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4

Źródła