IntersectionObserver.rootMargin

Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

IntersectionObserver 接口的只读属性**rootMargin**是与 CSS 属性margin语法相似的字符串 (string) 对象。在交叉检测开始之前,由rootMargin 规定的矩形的每一边都会被添加至root元素的边框盒 (bounding box (en-US)) 的相应边。例如,这可以让你向外调整边界,使得目标元素被认为是 100% 可见的,即使此元素得一部分长或宽被裁剪,或者在边缘过于靠近根边框盒边界的情况下,将目标视为部分隐藏。

可参考The root element and root margin in Intersection Observer API来深入了解 root margin 的工作原理或如何使其与根的边框盒进行协同工作。

语法

var marginString = IntersectionObserver.rootMargin;

一个字符串,形式与 CSS margin属性相似,包含了一条或一组根边框盒边的偏移量。这些偏移量会被添加至根边界盒与目标元素边界的交叉区域之前。

这个属性返回的字符串也许会与IntersectionObserver被配置时所指定的值有所差别。浏览器可以改变这些值。

如果 rootMargin 在对象初始化的时候未被指定,它将被设置成默认值``"0px 0px 0px 0px",这将意味着在原根节点边界框与目标边界之间计算交叉值。 The root element and root margin in Intersection Observer API 描述了 rootMargin 的更加深入的使用方法。

规范

Specification
Intersection Observer
# dom-intersectionobserver-rootmargin

浏览器兼容

BCD tables only load in the browser