IntersectionObserver: trackVisibility-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die trackVisibility-Eigenschaft der IntersectionObserver-Schnittstelle gibt an, ob der Beobachter neben der Element-Intersektion auch die Sichtbarkeit des Ziels verfolgt.

Wert

true, wenn die Sichtbarkeit für Intersektionen berechnet wird, und false andernfalls.

Der Wert wird über das option.trackVisibility-Argument an den IntersectionObserver()-Konstruktor übergeben.

Beschreibung

Wenn die Sichtbarkeit nicht verfolgt wird, gibt der Beobachter Benachrichtigungen, wenn das Ziel-Element in den Viewport des Root-Elements gescrollt wird. Dies sagt Ihnen jedoch nicht, ob die Sichtbarkeit des Ziel-Elements beeinträchtigt ist — es könnte teilweise von einem anderen Element verdeckt sein, reduzierte Deckkraft haben oder durch einen Filter, eine Transformation oder eine andere Modifikation verzerrt sein.

Bei der Verfolgung der Sichtbarkeit werden nur Elemente, die vom Browser als sichtbar angesehen werden, als durchschneidend angezeigt. Der Algorithmus ist konservativ und kann Elemente auslassen, die technisch sichtbar sind, wie solche mit nur leicht verringerter Deckkraft.

Beachten Sie, dass die Berechnung der Sichtbarkeit rechnerisch aufwändig ist. Um zu vermeiden, dass die Operation zu häufig läuft, wird eine delay verwendet, um die Mindestberichtsperiode zu begrenzen.

Spezifikationen

Specification
Intersection Observer
# dom-intersectionobserver-trackvisibility

Browser-Kompatibilität

Siehe auch