给图片保留尺寸,并把真实 url 存入 data-src。用 intersectionobserver 设置 rootmargin 扩大观察范围,图片接近视口时再写入 src 发起请求。

先准备本地图片和占位元素
把任意测试图片保存为同目录的 photo.jpg,将下面的元素放在足够长的页面底部,再添加监听脚本。
懒加载的本质是延迟资源请求。默认情况下,浏览器会立即解析 HTML 中的 标签并下载 src 指向的图片。为了实现懒加载,我们需要将真实的图片地址存储在自定义的数据属性(如 data-src)中,而将 src 设置为一个极小的占位图或直接留空。这样,初始 HTML 解析阶段不会触发网络请求。
<!-- 初始状态:src 为空或占位符,真实地址在 data-src --> <img class="lazy-image" alt="示例图片" style="max-width:90%" height="360" /> <!-- 可选:添加一个本地占位图以保持布局稳定 --> <img class="lazy-image" src="./placeholder.gif" alt="示例图片" style="max-width:90%" height="360" />

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;
配置 IntersectionObserver 监听器
IntersectionObserver API 允许异步观察目标元素与其祖先元素或顶级文档视口(viewport)的交叉状态变化。相比传统的 scroll 事件监听,它由浏览器原生优化,不会阻塞主线程。我们需要创建一个观察者实例,设置 rootMargin 以控制提前加载的距离,并定义回调函数来处理元素进入视口时的逻辑。
// 获取所有带有 lazy-image 类的图片
const images = document.querySelectorAll('.lazy-image');
// 创建观察者实例
const imageObserver = new IntersectionObserver((entries, observer) => {
entries.forEach(entry => {
// 如果图片进入视口
if (entry.isIntersecting) {
const img = entry.target;
// 从 data-src 获取真实地址并赋值给 src
img.src = img.dataset.src;
// 停止观察该元素,避免重复加载
observer.unobserve(img);
}
});
}, {
// rootMargin: "200px" 表示在图片距离视口 200px 时就开始加载
// 这有助于在网络较慢时,图片进入视口前已完成下载,提升体验
rootMargin: '200px',
threshold: 0.01 // 只要有一个像素可见即触发
});
// 开始观察每个图片元素
images.forEach(img => imageObserver.observe(img));处理异常分支与布局稳定性验证
在实际工程中,必须考虑图片加载失败的情况以及动态插入 DOM 的元素。如果图片加载失败,应提供错误处理逻辑;对于通过 JavaScript 动态添加的图片,需要确保它们也被纳入观察范围。此外,为了避免累积布局偏移(CLS),建议在 CSS 中为图片容器设置固定的宽高比或最小高度。
- 检查 dataset.src 是否存在,防止因属性缺失导致 src 被设为 undefined。
- 监听 load 和 error 事件,以便在图片加载完成后移除 loading 状态类名或显示错误图标。
- 对于动态内容,需在 DOM 更新后重新调用 observe()。
// 增强版:包含错误处理和动态元素支持
function initLazyLoading() {
const images = document.querySelectorAll('img[data-src]');
const observer = new IntersectionObserver((entries, obs) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
const img = entry.target;
// 验证数据源
if (!img.dataset.src) {
console.warn('Image missing data-src attribute');
return;
}
// 绑定一次性加载事件
const onLoad = () => {
img.classList.remove('loading');
img.classList.add('loaded');
img.removeEventListener('load', onLoad);
img.removeEventListener('error', onError);
obs.unobserve(img);
};
const onError = () => {
img.classList.remove('loading');
img.classList.add('error');
img.removeEventListener('load', onLoad);
img.removeEventListener('error', onError);
obs.unobserve(img);
};
img.addEventListener('load', onLoad);
img.addEventListener('error', onError);
// 触发加载
img.src = img.dataset.src;
}
});
}, { rootMargin: '100px' });
images.forEach(img => {
img.classList.add('loading'); // 用于 CSS 显示骨架屏或占位符
observer.observe(img);
});
}
// 假设后续通过 AJAX 添加了新图片
setTimeout(() => {
const newImg = document.createElement('img');
newImg.dataset.src = 'https://example.com/new-photo.jpg';
newImg.alt = '动态添加的图片';
document.body.appendChild(newImg);
// 注意:上述 initLazyLoading 需重新运行或设计为增量观察
// 更优做法是将 observer 保持全局引用,直接 observe 新元素
}, 3000);预期输出:页面初始加载时,Network 面板中仅显示占位图或无图片请求。当用户向下滚动,图片进入距视口 100px 的范围时,浏览器发起对 data-src 指定资源的请求。加载成功后,图片正常显示,且不再重复请求。若网络断开,图片显示错误状态,且不阻塞其他图片加载。

















