IntersectionObserverEntry

我们的志愿者还没有将这篇文章翻译为 中文 (简体)加入我们帮助完成翻译!
您也可以阅读此文章的English (US)版。

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The IntersectionObserverEntry interface of the Intersection Observer API describes the intersection between the target element and its root container at a specific moment of transition. Instances of IntersectionObserverEntry are delivered to an IntersectionObserver callback in its entries parameter; otherwise, these objects can only be obtained by calling IntersectionObserver.takeRecords().

Properties

IntersectionObserverEntry.boundingClientRect Read only
Returns the bounds rectangle of the target element as a DOMRectReadOnly. The bounds are computed as described in the documentation for Element.getBoundingClientRect().
IntersectionObserverEntry.intersectionRatio Read only
Returns the ratio of the intersectionRect to the boundingClientRect.
IntersectionObserverEntry.intersectionRect Read only
Returns a DOMRectReadOnly representing the target's visible area.
IntersectionObserverEntry.isIntersecting Read only
A Boolean value which is true if the target element intersects with the intersection observer's root. If this is true, then, the IntersectionObserverEntry describes a transition into a state of intersection; if it's false, then you know the transition is from intersecting to not-intersecting.
IntersectionObserverEntry.rootBounds Read only
Returns a DOMRectReadOnly for the intersection observer's root.
IntersectionObserverEntry.target Read only
The Element whose intersection with the root changed.
IntersectionObserverEntry.time Read only
A DOMHighResTimeStamp indicating the time at which the intersection was recorded, relative to the IntersectionObserver's time origin.

Methods

This interface has no methods.

Specifications

Specification Status Comment
Intersection Observer
The definition of 'IntersectionObserverEntry' in that specification.
Editor's Draft Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
boundingClientRect5115

53 — 551

55

No ? ?
intersectionRatio5115

53 — 551

55

No ? ?
intersectionRect5115

53 — 551

55

No ? ?
isIntersecting5115

53 — 551

55

No ? ?
rootBounds5115

53 — 551

55

No ? ?
target5115

53 — 551

55

No ? ?
time5115

53 — 551

55

No ? ?
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
boundingClientRect5151 (Yes) ? No ? ?
intersectionRatio5151 (Yes) ? No ? ?
intersectionRect5151 (Yes) ? No ? ?
isIntersecting5151 (Yes) ? No ? ?
rootBounds5151 (Yes) ? No ? ?
target5151 (Yes) ? No ? ?
time5151 (Yes) ? No ? ?

1. From version 53 until version 55 (exclusive): this feature is behind the dom.IntersectionObserver.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

文档标签和贡献者