IntersectionObserver: `root`-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.

Die root-schreibgeschützte Eigenschaft der IntersectionObserver-Schnittstelle identifiziert das Element oder das Document, dessen Grenzen als das Begrenzungsrechteck des Ansichtsfensters für das Element behandelt werden, das Ziel des Beobachters ist.

Wenn root null ist, werden die Grenzen des tatsächlichen Dokument-Ansichtsfensters verwendet.

Wert

Ein Element oder Document-Objekt, dessen Begrenzungsrechteck als Begrenzung des Ansichtsfensters verwendet wird, um zu bestimmen, wie viel vom Zielelement sichtbar ist. Der Schnittpunkt dieses Begrenzungsrechtecks, versetzt um alle in den Optionen angegebenen Ränder, die an den IntersectionObserver()-Konstruktor übergeben werden, die Begrenzungen des Zielelements, abzüglich der Begrenzungen jedes Elements oder anderen Objekts, das das Zielelement überlappt, wird als sichtbarer Bereich des Zielelements betrachtet.

Wenn root null ist, wird das eigentliche Dokument als Root verwendet, und die Grenzen seines Ansichtsfensters (das heißt, der sichtbare Bereich des Dokuments) werden als Root-Grenzen verwendet.

Beispiele

Dieses Beispiel setzt die border des Wurzelelements des IntersectionObserver auf eine 2-Pixel mittlere grüne Linie.

js
observer.root.style.border = "2px solid #44aa44";

Spezifikationen

Specification
Intersection Observer
# dom-intersectionobserver-root

Browser-Kompatibilität

Siehe auch