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 // ElementIntersectionObserverEntry 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
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserverEntry: target property
- IntersectionObserver: observe() method
- IntersectionObserver: IntersectionObserver() constructor
- HTML Standard — Web application APIs
- Intersection Observer specification — intersection geometry