IntersectionObserverEntry

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.

* Some parts of this feature may have varying levels of support.

IntersectionObserverEntry 接口 (从属于 Intersection Observer API ) 描述了目标元素与其根元素容器在某一特定过渡时刻的交叉状态。IntersectionObserverEntry 的实例作为 entries 参数被传递到一个 IntersectionObserver 的回调函数中; 此外,这些对象只能通过调用IntersectionObserver.takeRecords() 来获取。

属性

IntersectionObserverEntry.boundingClientRect 只读

返回包含目标元素的边界信息的DOMRectReadOnly. 边界的计算方式与 Element.getBoundingClientRect() 相同。

IntersectionObserverEntry.intersectionRatio 只读

返回intersectionRectboundingClientRect 的比例值。

IntersectionObserverEntry.intersectionRect 只读

返回一个 DOMRectReadOnly 用来描述根和目标元素的相交区域。

IntersectionObserverEntry.isIntersecting 只读

返回一个布尔值,如果目标元素与交叉区域观察者对象 (intersection observer) 的根相交,则返回 true .如果返回 true, 则 IntersectionObserverEntry 描述了变换到交叉时的状态; 如果返回 false, 那么可以由此判断,变换是从交叉状态到非交叉状态。

IntersectionObserverEntry.rootBounds 只读

返回一个 DOMRectReadOnly 用来描述交叉区域观察者 (intersection observer) 中的根。

IntersectionObserverEntry.target 只读

与根出现相交区域改变的元素 (Element).

IntersectionObserverEntry.time 只读

返回一个记录从 IntersectionObserver 的时间原点 (time origin) 到交叉被触发的时间的时间戳 (DOMHighResTimeStamp).

方法

此接口没有方法。

规范

Specification
Intersection Observer
# intersection-observer-entry

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
IntersectionObserverEntry
IntersectionObserverEntry() constructor
Experimental
boundingClientRect
intersectionRatio
intersectionRect
isIntersecting
isVisible
Experimental
rootBounds
target
time

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.