IntersectionObserver.observe()

IntersectionObserver.observe()方法用来启动对一个 DOM 元素的观察。该方法接受两个参数：回调函数callback和配置对象options。

callback 参数

目标元素的可见性变化时，就会调用观察器的回调函数callback。

callback会触发两次。一次是目标元素刚刚进入视口（开始可见），另一次是完全离开视口（开始不可见）。

  1. var observer = new IntersectionObserver(
  2.   (entries, observer) => {
  3.     console.log(entries);
  4.   }
  5. );

上面代码中，回调函数采用的是箭头函数的写法。callback函数的参数（entries）是一个数组，每个成员都是一个IntersectionObserverEntry对象（详见下文）。举例来说，如果同时有两个被观察的对象的可见性发生变化，entries数组就会有两个成员。

IntersectionObserverEntry 对象

IntersectionObserverEntry对象提供目标元素的信息，一共有六个属性。

  1. {
  2.   time: 3893.92,
  3.   rootBounds: ClientRect {
  4.     bottom: 920,
  5.     height: 1024,
  6.     left: 0,
  7.     right: 1024,
  8.     top: 0,
  9.     width: 920
  10.   },
  11.   boundingClientRect: ClientRect {
  12.      // ...
  13.   },
  14.   intersectionRect: ClientRect {
  15.     // ...
  16.   },
  17.   intersectionRatio: 0.54,
  18.   target: element
  19. }

每个属性的含义如下。

  • time：可见性发生变化的时间，是一个高精度时间戳，单位为毫秒
  • target：被观察的目标元素，是一个 DOM 节点对象
  • rootBounds：容器元素的矩形区域的信息，getBoundingClientRect()方法的返回值，如果没有容器元素（即直接相对于视口滚动），则返回null
  • boundingClientRect：目标元素的矩形区域的信息
  • intersectionRect：目标元素与视口（或容器元素）的交叉区域的信息
  • intersectionRatio：目标元素的可见比例，即intersectionRect占boundingClientRect的比例，完全可见时为1，完全不可见时小于等于0

IntersectionObserver.observe() - 图1

上图中，灰色的水平方框代表视口，深红色的区域代表四个被观察的目标元素。它们各自的intersectionRatio图中都已经注明。

我写了一个 Demo，演示IntersectionObserverEntry对象。注意，这个 Demo 只能在 Chrome 51+ 运行。

Option 对象

IntersectionObserver构造函数的第二个参数是一个配置对象。它可以设置以下属性。

（1）threshold 属性

threshold属性决定了什么时候触发回调函数，即元素进入视口（或者容器元素）多少比例时，执行回调函数。它是一个数组，每个成员都是一个门槛值，默认为[0]，即交叉比例（intersectionRatio）达到0时触发回调函数。

如果threshold属性是0.5，当元素进入视口50%时，触发回调函数。如果值为[0.3, 0.6]，则当元素进入30％和60％是触发回调函数。

  1. new IntersectionObserver(
  2.   entries => {/* … */},
  3.   {
  4.     threshold: [0, 0.25, 0.5, 0.75, 1]
  5.   }
  6. );

用户可以自定义这个数组。比如，上例的[0, 0.25, 0.5, 0.75, 1]就表示当目标元素 0%、25%、50%、75%、100% 可见时，会触发回调函数。

IntersectionObserver.observe() - 图2

（2）root 属性，rootMargin 属性

IntersectionObserver不仅可以观察元素相对于视口的可见性，还可以观察元素相对于其所在容器的可见性。容器内滚动也会影响目标元素的可见性，参见本文开始时的那张示意图。

IntersectionObserver API 支持容器内滚动。root属性指定目标元素所在的容器节点。注意，容器元素必须是目标元素的祖先节点。

  1. var opts = {
  2.   root: document.querySelector('.container'),
  3.   rootMargin: '0px 0px -200px 0px'
  4. };
  6. var observer = new IntersectionObserver(
  7.   callback,
  8.   opts
  9. );

上面代码中，除了root属性，还有rootMargin属性。该属性用来扩展或缩小rootBounds这个矩形的大小，从而影响intersectionRect交叉区域的大小。它的写法类似于 CSS 的margin属性，比如0px 0px 0px 0px，依次表示 top、right、bottom 和 left 四个方向的值。

上例的0px 0px -200px 0px，表示容器的下边缘向上收缩200像素，导致页面向下滚动时，目标元素的顶部进入可视区域200像素以后，才会触发回调函数。

这样设置以后，不管是窗口滚动或者容器内滚动，只要目标元素可见性变化，都会触发观察器。