`

交叉观察器IntersectionObserver API

 
阅读更多

(转自http://www.ruanyifeng.com/blog/2016/11/intersectionobserver_api.html)

网页开发时,常常需要了解某个元素是否进入了"视口"(viewport),即用户能不能看到它。

上图的绿色方块不断滚动,顶部会提示它的可见性。

传统的实现方法是,监听到scroll事件后,调用目标元素(绿色方块)的getBoundingClientRect()方法,得到它对应于视口左上角的坐标,再判断是否在视口之内。这种方法的缺点是,由于scroll事件密集发生,计算量很大,容易造成性能问题

目前有一个新的 IntersectionObserver API,可以自动"观察"元素是否可见,Chrome 51+ 已经支持。由于可见(visible)的本质是,目标元素与视口产生一个交叉区,所以这个 API 叫做"交叉观察器"。

一、API

它的用法非常简单。


var io = new IntersectionObserver(callback, option);

上面代码中,IntersectionObserver是浏览器原生提供的构造函数,接受两个参数:callback是可见性变化时的回调函数,option是配置对象(该参数可选)。

构造函数的返回值是一个观察器实例。实例的observe方法可以指定观察哪个 DOM 节点。


// 开始观察
io.observe(document.getElementById('example'));

// 停止观察
io.unobserve(element);

// 关闭观察器
io.disconnect();

上面代码中,observe的参数是一个 DOM 节点对象。如果要观察多个节点,就要多次调用这个方法。


io.observe(elementA);
io.observe(elementB);

二、callback 参数

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

callback一般会触发两次。一次是目标元素刚刚进入视口(开始可见),另一次是完全离开视口(开始不可见)。


var io = new IntersectionObserver(
  entries => {
    console.log(entries);
  }
);

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

三、IntersectionObserverEntry 对象

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


{
  time: 3893.92,
  rootBounds: ClientRect {
    bottom: 920,
    height: 1024,
    left: 0,
    right: 1024,
    top: 0,
    width: 920
  },
  boundingClientRect: ClientRect {
     // ...
  },
  intersectionRect: ClientRect {
    // ...
  },
  intersectionRatio: 0.54,
  target: element
}

每个属性的含义如下。

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

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

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

四、实例:惰性加载(lazy load)

有时,我们希望某些静态资源(比如图片),只有用户向下滚动,它们进入视口时才加载,这样可以节省带宽,提高网页性能。这就叫做"惰性加载"。

有了 IntersectionObserver API,实现起来就很容易了。


function query(selector) {
  return Array.from(document.querySelectorAll(selector));
}

var observer = new IntersectionObserver(
  function(changes) {
    changes.forEach(function(change) {
      var container = change.target;
      var content = container.querySelector('template').content;
      container.appendChild(content);
      observer.unobserve(container);
    });
  }
);

query('.lazy-loaded').forEach(function (item) {
  observer.observe(item);
});

上面代码中,只有目标区域可见时,才会将模板内容插入真实 DOM,从而引发静态资源的加载。

五、实例:无限滚动

无限滚动(infinite scroll)的实现也很简单。


var intersectionObserver = new IntersectionObserver(
  function (entries) {
    // 如果不可见,就返回
    if (entries[0].intersectionRatio <= 0) return;
    loadItems(10);
    console.log('Loaded new items');
  });

// 开始观察
intersectionObserver.observe(
  document.querySelector('.scrollerFooter')
);

无限滚动时,最好在页面底部有一个页尾栏(又称sentinels)。一旦页尾栏可见,就表示用户到达了页面底部,从而加载新的条目放在页尾栏前面。这样做的好处是,不需要再一次调用observe()方法,现有的IntersectionObserver可以保持使用。

六、Option 对象

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

6.1 threshold 属性

threshold属性决定了什么时候触发回调函数。它是一个数组,每个成员都是一个门槛值,默认为[0],即交叉比例(intersectionRatio)达到0时触发回调函数。


new IntersectionObserver(
  entries => {/* ... */}, 
  {
    threshold: [0, 0.25, 0.5, 0.75, 1]
  }
);

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

6.2 root 属性,rootMargin 属性

很多时候,目标元素不仅会随着窗口滚动,还会在容器里面滚动(比如在iframe窗口里滚动)。容器内滚动也会影响目标元素的可见性,参见本文开始时的那张示意图。

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


var opts = { 
  root: document.querySelector('.container'),
  rootMargin: "500px 0px" 
};

var observer = new IntersectionObserver(
  callback,
  opts
);

上面代码中,除了root属性,还有rootMargin属性。后者定义根元素的margin,用来扩展或缩小rootBounds这个矩形的大小,从而影响intersectionRect交叉区域的大小。它使用CSS的定义方法,比如10px 20px 30px 40px,表示 top、right、bottom 和 left 四个方向的值。

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

七、注意点

IntersectionObserver API 是异步的,不随着目标元素的滚动同步触发。

规格写明,IntersectionObserver的实现,应该采用requestIdleCallback(),即只有线程空闲下来,才会执行观察器。这意味着,这个观察器的优先级非常低,只在其他任务执行完,浏览器有了空闲才会执行。

八、参考链接

(完)

分享到:
评论

相关推荐

    lazyImage:使用interSectionObserver API异步加载图片

    使用interSectionObserver API异步加载图片 当前懒加载图片的方法 要想知道当前是否需要加载一张图片,我们需要坚持当前页面可见范围内这张图片是否可见。如果是,则加载。 检查方法:我们可以通过事件和事件处理器...

    liukexina#weekly#交叉观察器1

    由于可见(visible)的本质是,目标元素与视口产生一个交叉区,所以这个 API 叫做"交叉观察器"。// 开始观察// 停止观察// 关闭观察器例子用于图片

    MC滑膜观察器 代码-FOC

    【标题】MC滑膜观察器 代码-FOC 【正文】 MC滑膜观察器(Magnetic Compass Sliding Mode Observer,简称MC-SMO)是一种在电机控制领域中用于估算电机状态变量的重要算法。该观察器设计的目标是实时、准确地估计...

    IntersectionObserver实现图片懒加载的示例

    IntersectionObserver是Web API中的一种新的API,用于观察目标元素与视窗或其他元素之间的交叉状态。通过使用IntersectionObserver,我们可以实现在页面滚动时,异步加载图片,从而提高页面的加载速度和用户体验。 ...

    程序观察器

    程序观察器程序观察器程序观察器

    vue-intersect:Vue组件,用于将交叉观察器添加到Vue组件或HTML元素

    Vue组件,用于将交叉观察器添加到Vue组件或HTML元素。 表中的内容 介绍 是一个了不起的API,可让您观察一个或多个HTMLElement进入或离开视口的时间。 当元素进入视口时,此API有许多用例,例如无限滚动,延迟加载或...

    谈谈IntersectionObserver懒加载的具体使用

    `IntersectionObserver` 接口的构造函数 `new IntersectionObserver(callback, options)` 创建了一个观察器实例,`callback` 是当元素的可见性发生变化时执行的回调函数,`options` 是一组配置参数,如: ...

    IntersectionObserver

    当不再需要整个观察器时,使用`disconnect()`来停止所有观察: ```javascript observer.disconnect(); ``` ### 3. 配置选项 - **root**: 可选参数,设定观察的参考区域,默认为浏览器视口。 - **rootMargin**: ...

    混沌图像观察windows API程序

    标题中的“混沌图像观察windows API程序”指的是一个利用Windows API函数来实现对混沌图像的观察和分析的应用程序。混沌图像通常是由复杂的数学算法生成的,它们具有非线性动力学特性,表现出高度的敏感依赖于初始...

    基于决策树的n则交叉验证分类器

    在本主题中,“基于决策树的n则交叉验证分类器”指的是利用决策树算法,并结合交叉验证方法来提高分类器的性能和泛化能力。 交叉验证是一种统计学上的评估方法,用于减少模型的过拟合风险。在n折交叉验证中,原始...

    WEBAPI多线程并发测试工具

    6. **压力测试**:通过模拟大量并发请求,观察API性能下降的临界点,找出系统的弱点。 7. **负载测试**:长时间保持高负载,检查系统的稳定性和资源消耗。 8. **故障注入**:模拟网络延迟、断开连接或其他异常情况,...

    句柄观察器

    "句柄观察器"是一个基于Borland Delphi 5.0开发的系统工具,它主要用于帮助程序员或者系统管理员查看和分析系统中的句柄资源。在Windows操作系统中,句柄是系统用来标识和访问对象(如窗口、文件、设备等)的一种...

    IntersectionObserver:路口观察员

    交叉口观察员 实施状态: Chrome: 边缘: Firefox: WebKit:

    Vuejs组件使用IntersectionObserverAPI在进入viewport时自动加载图像

    当元素进入或离开视口时,观察器会触发一个回调函数,传递一个包含交集信息的IntersectionObserverEntry对象数组。 在Vue.js组件中,我们可以创建一个自定义组件`VLazyImage`,这个组件将利用Intersection Observer...

    javascrip高级前端开发常用的几个API示例详解.docx

    IntersectionObserver API 提供了一种简单有效的方式来实现这种功能。 ```javascript const options = { root: null, rootMargin: '0px', threshold: 0.5 }; const images = document.querySelectorAll('.lazy'...

    HookAPI例子

    3. 运行主程序,观察HookAPI如何影响示例API的调用。 4. 修改Hook库或主程序的代码,尝试不同的Hook策略和处理逻辑,以加深理解和掌握。 总的来说,HookAPI技术是一个强大的工具,但使用时需谨慎,因为它可能影响...

    java api1.6、1.7

    2. **NIO.2**:增加了新的文件系统API,支持文件观察、路径操作和异步I/O,使得文件操作更加灵活高效。 3. **Swing增强**:包括更好的LookAndFeel集成,以及JTable和JTree组件的性能提升。 4. **动态代理**:增强了...

    符号文件观察器——symview(for msdia90)

    《符号文件观察器——Symview for MSDia90:深入解析与应用》 在软件开发过程中,符号文件(Symbol Files)扮演着至关重要的角色。它们存储了程序的调试信息,如变量名、函数名和行号,使得调试过程更为直观和高效...

    apispy API超级hook工具

    4. **查看与分析**:在apispy的用户界面上,观察和分析API调用的实时信息。 5. **日志管理**:保存和导出日志文件,以便离线分析或与其他工具配合使用。 6. **解除钩子**:完成分析后,解除钩子以恢复正常系统行为...

    949716583534019DR-API调试工具_v1.0.zip

    然后,通过工具进行API的尝试调用,观察结果,逐步调试和完善自己的代码。此外,工具可能还提供了一些高级功能,如批量测试、自动化脚本编写等,以提高调试效率。 总的来说,DR-API调试工具_v1.0是开发者调试和优化...

Global site tag (gtag.js) - Google Analytics