IntersectionObserver 工程实践:从曝光统计到滚动容器边界的完整实现
为什么又要把 IntersectionObserver 翻出来讲
曝光统计、图片懒加载、无限滚动触发、埋点可视区域判定,这四类需求在前端几乎每个项目都会遇到。早期实现清一色是监听 scroll 事件 + getBoundingClientRect(),能跑,但在中低端安卓机上会稳定掉帧。我们线上一个商品列表页做过多轮对比:同一台 Redmi Note 11 上,scroll 方案的滚动平均帧率 42fps,长列表快速滑动时出现 80–120ms 的长任务;换成 IntersectionObserver 后平均帧率回到 55fps 以上,长任务基本消失。原因很直接——getBoundingClientRect() 强制同步布局,scroll 回调里读它等于每帧触发一次 layout;而 IntersectionObserver 的交叉计算在合成线程侧完成,回调是异步派发的,不阻塞滚动。
但很多人换到 IO 之后仍然踩坑,因为 IO 的语义比 scroll 方案隐晦得多:它不告诉你"元素在哪",只告诉你"交叉比例跨过阈值了"。这篇文章把我在三个业务里踩过的坑按顺序讲清楚。
一、基础结构与回调语义
const io = new IntersectionObserver((entries) => {
for (const entry of entries) {
// entry.isIntersecting 表示当前是否与 root 相交
// entry.intersectionRatio 是相交面积占目标面积的比例,0~1
// entry.boundingClientRect 是元素自身的视口坐标(同步值,不会引发布局)
if (entry.isIntersecting && entry.intersectionRatio >= 0.5) {
reportExposure(entry.target.dataset.id);
io.unobserve(entry.target); // 曝光只上报一次,立即停止观察
}
}
}, {
root: null, // null 表示浏览器视口
rootMargin: '0px',
threshold: [0, 0.5, 1]
});
document.querySelectorAll('.goods-card').forEach(el => io.observe(el));
三个配置项里,threshold 最容易被误解:它不是"每隔多少比例触发一次",而是"跨越这些比例时触发"。给 [0, 0.5, 1],元素从完全不可见滚到完全可见,理论上会依次触发 ratio=0、0.5、1 三次回调;但浏览器会把同一帧内的多次跨越合并成一次回调,所以实际次数往往少于预期。如果业务需要精确的停留时长,不要依赖 threshold 次数,而是记录进入和离开两个时间点做差。
二、root 只能是滚动容器本身,不能是任意祖先
这是最贵的坑。IO 的 root 语义是"裁剪容器",它必须是目标元素的滚动祖先或包含块,否则交叉计算会退化——Chrome 里表现为永远 isIntersecting=false,Safari 里则是行为不一致地偶尔触发。
我们有个弹窗内的横向商品流,结构是 .modal > .scroller > .track > .item,滚动发生在 .track 上(用了 CSS scroll-snap)。最初把 root 传成 .modal,曝光量直接归零。改成 .track 才正常。判定方法很简单:从目标元素往上找,第一个 overflow 为 auto/scroll 且实际产生了滚动的祖先,就是 root。
function findScrollParent(el) {
let p = el.parentElement;
while (p && p !== document.body) {
const s = getComputedStyle(p);
if (/(auto|scroll)/.test(s.overflowY) && p.scrollHeight > p.clientHeight) return p;
p = p.parentElement;
}
return null;
}
三、rootMargin 的四个值是"收缩 root",不是"扩张元素"
懒加载场景常用 rootMargin: '200px 0px' 提前 200px 开始加载。注意它的作用对象是 root 的边界框:正值向外扩,负值向内缩。负值经常被用来做"必须完整进入视口才算曝光":rootMargin: '-10% 0px' 等价于把视口上下各裁掉 10%,只统计中间 80% 区域。这比用 threshold 更稳,因为 threshold 在超高元素(比如高度大于视口的 Banner)上永远到不了 1。
另一个细节:rootMargin 的百分比是相对 root 的尺寸计算的,root 是视口时相对视口高度,root 是元素时相对该元素高度。滚动容器只有 300px 高时,-10% 只裁 30px,别按页面高度去估。
四、首屏元素不触发回调
规范里 IO 在 observe 之后会异步做一次初始计算,理论上首屏可见元素会触发一次 ratio>0 的回调。但实测中如果元素在 observe 之前就完成了布局,且回调尚未派发时发生了重排(比如字体加载导致文本换行、图片撑开高度),这次初始计算可能读到的是旧的几何信息,表现为"首屏几张卡片没有曝光数据"。
工程上的稳妥做法是:注册后立即同步判一次首屏。
const rect = el.getBoundingClientRect();
const vh = window.innerHeight;
if (rect.top < vh && rect.bottom > 0) {
markVisible(el); // 首屏同步判定,之后交给 IO 管增量
} else {
io.observe(el);
}
首屏这批元素的 getBoundingClientRect() 只读一次,开销可以忽略,换来的是曝光数据的完整性。
五、display:none 与 0 尺寸元素
目标元素或它的任一祖先处于 display:none 时,getBoundingClientRect() 全为 0,IO 会认为元素面积为 0,intersectionRatio 恒为 0,永远不会触发。tab 切换、折叠面板里藏着的列表就是典型场景。解决方式不是猜阈值,而是在容器变为可见时重新 observe:
tab.addEventListener('change', () => {
// 先断开再重新观察,强制浏览器重算一次几何
list.forEach(el => { io.unobserve(el); io.observe(el); });
});
注意 unobserve + observe 会重置该元素的内部状态,之前已上报的曝光要自己去重,别指望浏览器记着。
六、曝光去重与停留时长
只上报 isIntersecting 会重复计数:用户来回滚动,同一张卡会被上报多次。常见做法是元素上挂一个上报标记,或者在 Map 里记状态机:
const seen = new WeakSet();
const timers = new WeakMap();
function onEntry(entry) {
const el = entry.target;
if (entry.isIntersecting && entry.intersectionRatio >= 0.5) {
if (!timers.has(el)) {
timers.set(el, performance.now());
}
} else if (timers.has(el)) {
const dwell = performance.now() - timers.get(el);
timers.delete(el);
if (dwell >= 1000 && !seen.has(el)) {
seen.add(el);
queue.push({ id: el.dataset.id, dwell: Math.round(dwell) });
}
}
}
用 performance.now() 而不是 Date.now(),避免系统时间调整导致负数停留时长。另外阈值用 0.5 而非 1:卡片高度超过视口一半时,ratio 永远超不过 0.5 的兄弟元素(比如整屏 Banner 加半屏卡片)需要按业务单独配置,不要全局硬编码。
七、和 content-visibility 的组合问题
为了优化长列表首屏,我们会给屏幕外区块加 content-visibility: auto。这会让浏览器跳过内部渲染,此时内部元素的几何信息是占位尺寸,IO 仍然能算交叉,但一旦元素进入接近区域触发渲染,真实高度变化会让之前的交叉结论失效,出现"曝光上报了但用户其实没看到"的误判。稳妥策略是:被 content-visibility 包裹的子树,把曝光判定放在外层容器上,而不是内部每一个子元素上。
八、实测结论
- 同一列表页(200 张卡片、中端安卓机):scroll + getBoundingClientRect 方案滚动帧率 42fps,IO 方案 55fps;长任务数量从每次滑动 3–5 个降到 0。
- IO 回调本身的开销极低,把 200 个元素的回调合并后一次性上报(
requestIdleCallback批量 flush),单次 flush 平均 3–6ms。 - 坑位分布:root 传错占问题总量约一半,首屏不触发约三成,display:none 与动态插入各占一成。
一句话总结:IntersectionObserver 解决的是"交叉判定不要放在主线程"这个问题,它的 API 很薄,但语义边界(root 必须是滚动祖先、rootMargin 收缩的是 root、0 尺寸元素永不触发)需要记住,否则会出现"代码没报错、数据全为空"的静默故障,排查成本远高于当初省下的那点性能。
- 点赞
- 收藏
- 关注作者
评论(0)