我的数字人生

图片懒加载:IntersectionObserver 的三种用法

2026 年 10 月 27 日 · 约 7 分钟读完

以前做懒加载都是监听 scroll,每次滚动算一遍 getBoundingClientRect(),几十张图就明显掉帧。换成 IntersectionObserver 之后,代码少了六十多行,滚动也顺了。

最小可用版本

<img data-src="/img/a.jpg" alt="示例">
const io = new IntersectionObserver((entries) => {
  entries.forEach(entry => {
    if (!entry.isIntersecting) return;
    const img = entry.target;
    img.src = img.dataset.src;
    io.unobserve(img);
  });
}, { rootMargin: '200px' });

document.querySelectorAll('img[data-src]').forEach(img => io.observe(img));

rootMargin: '200px' 让图片在进入视口前 200px 就开始加载,用户滚到的时候图已经好了。这个值太大会浪费流量,太小会看到白块,我一般在 200~400 之间试。

加载完记得 unobserve,否则这个元素会一直被观察,长列表里会越积越多。

场景二:长文配图,要防抖动

文章里的图如果没写死尺寸,加载完会把下面的文字往下顶,读一读页面就跳一下。这个体验很糟。

解决办法是给容器写死宽高比:

.figure {
  aspect-ratio: 16 / 9;
  background: #f0eee8;
  overflow: hidden;
}

.figure img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  opacity: 0;
  transition: opacity .3s;
}

.figure img.loaded { opacity: 1; }

aspect-ratio 现在兼容性已经很好了。图片加载完加个 loaded 类做淡入,比直接"啪"一下出现舒服。

如果图片比例不统一,就得在服务端返回宽高,用 width/height 属性撑住空间。别偷懒,这一步省了,用户读文章会一直被打断。

场景三:横向滚动容器

做了个横向滑动的图集,习惯性用默认配置,结果所有图一次性全加载了。原因是 IntersectionObserver 默认以视口为参照,横向容器里的图只要在视口范围内就被判定为可见。

要用 root 指定滚动容器:

const scroller = document.querySelector('.gallery');

const io = new IntersectionObserver(callback, {
  root: scroller,
  rootMargin: '0px 300px',
  threshold: 0
});

注意 root 必须是那个"真正滚动"的祖先元素,否则不生效。我当时把 root 设成了 .gallery__inner(实际不滚动),怎么都不触发。

一个容易忽略的坑

图片加载失败时,src 已经写上去了,但显示的是破图。而且 observe 已经取消,重试都没机会。

可以加个兜底:

img.addEventListener('error', function onErr() {
  this.src = '/img/placeholder.svg';
  this.classList.add('loaded');
}, { once: true });

另外,如果图片是从 data-src 换过去,记得同步更新 srcset 和 sizes,不然响应式图片会失效。

要不要用原生 loading="lazy"

现在 <img loading="lazy"> 已经广泛支持,大多数情况直接用它就够,一行搞定。

但它有两个限制:不能精确控制触发距离,也没法在加载完成后做动画。我做那个图集需要"提前 300px 预载 + 淡入",原生属性做不到,才改用 IntersectionObserver。

默认用原生 loading="lazy",需要精细控制时才上 IntersectionObserver。别为了炫技把简单的事写复杂。
← 返回首页