滚动懒加载动效需三步协同:先用IntersectionObserver配合rootMargin提前感知、再等图片load完成才触发CSS动效、最后用aspect-ratio和transition稳住布局;每个元素单独observe并及时unobserve。

滚动动画配合 IntersectionObserver 实现懒加载动效,核心是“先感知、再加载、后动效”,三步不串行、不抢跑。关键不是等用户滚到才开始干活,而是提前预判、稳住布局、等资源就绪再启动动画。
用 rootMargin 提前触发加载
图片或动效元素不能等到完全进入视口才开始加载,否则快速滚动时会看到空白或占位图闪一下。通过 rootMargin 设置缓冲区,让浏览器提前“嗅探”:
- 底部多预留 200px:{ rootMargin: "0px 0px 200px 0px" },适合向下滚动为主的长页
- 上下都留:{ rootMargin: "100px 0px" },适合图文交错、需双向响应的页面
- 避免设过大(如 500px+),否则可能提前加载大量非必要资源
动效必须等图片真实加载完成
只监听 isIntersecting 容易导致“动画已播、图还没出来”。正确做法是把动效绑定在图片的 load 事件上:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- HTML 中保留 loading 占位:
- JS 中先替换 src,再监听 load:
img.src = img.dataset.src; img.addEventListener('load', () => img.classList.add('loaded')); - 失败也要兜底:
img.addEventListener('error', () => { img.src = 'fallback.jpg'; img.classList.add('loaded'); });
CSS 层要稳住高度、平滑过渡
动效前若 DOM 高度塌陷,滚动中页面会突然上跳。必须用 CSS 占位 + 过渡属性保障视觉连贯:
- 用 aspect-ratio 固定宽高比:
img { aspect-ratio: 4/3; background: #f5f5f5; } - 初始状态隐藏但保留空间:
.fade-in { opacity: 0; transform: translateY(20px); } - 动效类加过渡和硬件加速:
.loaded { opacity: 1; transform: translateY(0); transition: opacity 0.4s, transform 0.4s; will-change: opacity, transform; }
每个元素单独观察、及时停止
别把所有图片塞进同一个 observer 后靠 class 区分——容易误触发。应为每个目标元素单独 observe,并在动效启动后立即 unobserve:
- 遍历所有目标元素:
document.querySelectorAll('.fade-in').forEach(img => observer.observe(img)); - 回调中只处理当前 entry:
if (entry.isIntersecting) { handleImageLoad(entry.target); observer.unobserve(entry.target); } - 避免重复执行,也减少内存占用










