在前端开发中,我们经常需要判断某个元素是否进入视口,比如实现图片懒加载、无限滚动加载更多内容、统计元素曝光次数等场景。传统做法是通过监听滚动事件,手动计算元素的位置和视口的关系,这种方式不仅代码繁琐,还容易因为频繁触发滚动事件导致性能问题。而Intersection Observer API就是专门解决这类问题的原生接口,它可以在元素可见性发生变化时异步触发回调,不需要手动计算位置,性能表现更优秀。

基本使用步骤
使用Intersection Observer API的核心流程分为三步:创建观察者实例、定义回调函数、指定要观察的目标元素。
1. 创建观察者实例
首先需要通过IntersectionObserver构造函数创建实例,构造函数接收两个参数:可见性变化时的回调函数,以及可选的配置对象。
// 创建Intersection Observer实例
const observer = new IntersectionObserver(
// 回调函数,当被观察元素的可见性变化时执行
(entries) => {
entries.forEach(entry => {
// entry对象包含目标元素的可见性相关信息
console.log('目标元素:', entry.target);
console.log('是否进入视口:', entry.isIntersecting);
console.log('可见比例:', entry.intersectionRatio);
});
},
// 可选的配置对象
{
root: null, // 指定观察的根元素,null表示默认使用浏览器视口作为根
rootMargin: '0px', // 根元素的边距,类似CSS的margin,可用来提前或延后触发回调
threshold: 0 // 触发回调的可见比例阈值,0表示元素刚进入视口就触发,1表示完全进入视口才触发
}
);2. 指定观察目标元素
创建实例后,需要调用实例的observe方法,传入要观察的DOM元素,就可以开始监听该元素的可见性变化了。
// 获取要观察的目标元素
const targetElement = document.querySelector('.lazy-load-img');
// 开始观察目标元素
observer.observe(targetElement);3. 停止观察
当不需要再监听某个元素的可见性时,可以调用unobserve方法停止观察,或者调用disconnect方法停止观察所有目标元素。
// 停止观察单个目标元素 observer.unobserve(targetElement); // 停止观察所有目标元素 observer.disconnect();
核心配置参数说明
创建Intersection Observer实例时的配置对象有几个核心参数,理解这些参数可以帮助我们更灵活地控制观察行为。
| 参数名 | 类型 | 说明 |
|---|---|---|
| root | Element/null | 指定作为视口的根元素,默认值为null,表示使用浏览器视口作为根。如果需要观察元素在某个容器内的可见性,可以传入该容器的DOM元素 |
| rootMargin | String | 根元素的边距,语法和CSS的margin一致,支持px、%等单位。比如设置为'100px'表示根元素的边界向外扩展100px,元素进入扩展后的区域就会触发回调,可以用来提前加载内容 |
| threshold | Number/Array | 触发回调的可见比例阈值,取值范围是0到1。如果是单个数字,表示可见比例达到该值时触发回调;如果是数组,表示可见比例达到数组中的任意一个值时都会触发回调。比如[0, 0.5, 1]表示元素刚进入视口、可见一半、完全进入视口时都会触发回调 |
常见使用场景示例
场景1:图片懒加载
图片懒加载是Intersection Observer API最常见的应用场景,只有当图片进入视口时才加载真实的图片地址,减少初始页面的请求数量。
// 获取所有需要懒加载的图片元素
const lazyImages = document.querySelectorAll('img[data-src]');
// 创建观察者实例
const lazyLoadObserver = new IntersectionObserver(
(entries) => {
entries.forEach(entry => {
// 判断元素是否进入视口
if (entry.isIntersecting) {
const img = entry.target;
// 将data-src的属性值赋值给src,加载真实图片
img.src = img.dataset.src;
// 加载完成后停止观察该图片
lazyLoadObserver.unobserve(img);
}
});
},
{
rootMargin: '200px' // 提前200px触发加载,提升用户体验
}
);
// 遍历所有懒加载图片,开始观察
lazyImages.forEach(img => {
lazyLoadObserver.observe(img);
});场景2:无限滚动加载
无限滚动场景中,我们可以在列表底部放一个加载提示元素,当这个元素进入视口时就请求加载更多数据。
// 获取底部的加载提示元素
const loadMoreTrigger = document.querySelector('.load-more-trigger');
// 模拟加载数据的函数
function loadMoreData() {
console.log('开始加载更多数据...');
// 这里可以写请求接口、渲染新列表的逻辑
}
// 创建观察者实例
const infiniteScrollObserver = new IntersectionObserver(
(entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
// 触发加载更多
loadMoreData();
}
});
}
);
// 开始观察加载提示元素
infiniteScrollObserver.observe(loadMoreTrigger);注意事项
- Intersection Observer API是异步触发的,回调函数的执行时机是在主线程空闲时,不会阻塞页面的渲染和交互。
- 如果要观察的元素一开始就处于视口中,创建观察者并开始观察后,回调函数会立即执行一次。
- 该API在IE浏览器中不支持,如果需要兼容IE,需要引入对应的polyfill库。
- rootMargin的设置不会影响根元素本身的实际布局,只是用来计算可见性时的边界扩展。
Intersection_Observer_APIJavaScript元素可见性监听懒加载滚动监听修改时间:2026-05-29 03:33:29