IntersectionObserver:rootMargin 属性

基线 广泛可用

此功能已得到良好建立,并在许多设备和浏览器版本上运行。 它自 2019 年 3 月.

报告反馈

IntersectionObserver 接口的只读 rootMargin 属性是一个字符串,其语法类似于 CSS margin 属性的语法。 rootMargin 表示的矩形的每一侧都将添加到 root 元素的 边界框 中的对应侧,然后再执行交叉检测。 例如,这使您可以将边界向外调整,以便即使目标元素的宽度或高度被裁剪掉一定数量的像素,目标元素也被视为 100% 可见,或者如果目标元素的边缘距离根元素边界框的边缘太近,则将目标元素视为部分隐藏。

查看 交叉点如何计算,以深入了解根边距以及它如何与根边界框一起工作。

一个字符串,其格式类似于 CSS margin 属性的值,其中包含根边界框的一个或多个侧面的偏移量。 这些偏移量在计算根边界框与目标元素边界之间的交叉点之前,会添加到根边界框中的对应值。

此属性返回的字符串可能与 IntersectionObserver 实例化时指定的字符串不匹配。 浏览器可以更改这些值

规范

如果在实例化对象时未指定 rootMargin,则其默认值为字符串 "0px 0px 0px 0px",这意味着交叉点将在根元素未修改的边界矩形与目标边界之间计算。 交叉点如何计算 更详细地描述了如何使用 rootMargin
规范
# Intersection Observer

浏览器兼容性

dom-intersectionobserver-rootmargin