当前位置：首页 > 文章列表 > 文章 > 前端 > CSS滚动动画：IntersectionObserver实战教程

CSS滚动动画：IntersectionObserver实战教程

2026-02-24 10:25:50 0浏览收藏

Intersection Observer 触发滚动动画的最小可行写法

直接用 IntersectionObserver 监听元素进入视口，比监听 window.onscroll 更轻量、更可靠——它不随滚动频繁触发，也不受节流误判影响。

常见错误是等 DOM 渲染完才初始化 Observer，结果首屏元素没被观测到；或者漏掉 rootMargin，导致动画在元素刚露头时就执行，用户根本看不到过渡过程。

必须在元素挂载后（如 document.querySelectorAll(".anim-trigger") 有结果）再创建 Observer
rootMargin: "0px 0px -20% 0px" 是常用值：让动画提前在元素还有 20% 高度未进入视口时启动，避免“闪入”
回调中对每个 entry 要检查 entry.isIntersecting，否则元素移出视口时也会触发（可能造成重复动画）

const observer = new IntersectionObserver((entries) => {
  entries.forEach(entry => {
    if (entry.isIntersecting) {
      entry.target.classList.add("animate-in");
      observer.unobserve(entry.target); // 动画只执行一次
    }
  });
}, { rootMargin: "0px 0px -20% 0px" });
document.querySelectorAll(".anim-trigger").forEach(el => observer.observe(el));

CSS 动画类名要配 `animation-fill-mode: forwards`

否则动画播完立刻回退到初始状态，比如 translateY(0) → translateY(20px) 播完又弹回 0，视觉上就是“动一下又消失”。

另一个坑是把 opacity 和位移动画写在同一个 @keyframes 里但没设起始透明度，导致元素默认 opacity: 0 却没隐藏，布局占位异常。

动画类必须含 animation-fill-mode: forwards
若用 opacity，初始状态得显式设为 opacity: 0，且确保父容器没强制撑高
避免在动画中改 height 或 display，会触发重排，卡顿明显

.animate-in {
  opacity: 0;
  transform: translateY(30px);
  animation: slideIn 0.6s ease-out forwards;
}
@keyframes slideIn {
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

兼容性兜底：Safari 15.4 以下不支持 `rootMargin` 百分比值

Safari ≤15.4 会直接忽略 rootMargin: "-20%"，退化成 "0px"，导致动画触发太晚甚至不触发。这不是 bug，是规范早期实现差异。

不能靠 UA 判断，因为 iOS WebView 行为也不一致；稳妥做法是用像素值替代，或加一层 JS 计算。

最简方案：把 rootMargin 改成 "0px 0px -100px 0px"（假设平均设备视口高度约 500px，-20% ≈ -100px）
进阶方案：用 window.innerHeight * 0.2 动态算像素值，再拼字符串传给 rootMargin
不推荐 fallback 到 scroll 监听——性能和体验差距太大，真要兼容老 Safari 就老实做降级动画（如无位移，只淡入）

多个动画顺序错乱？别依赖 DOM 顺序，用 `threshold` 分层控制

当一页有十几个动效元素，按 DOM 顺序 observe 后，它们几乎同时触发，看不出逐个浮现的节奏感。想实现“从上到下依次入场”，靠 CSS animation-delay 不稳定（JS 添加 class 时间不可控），也不该手动 setTimeout。

真正可控的方式是用 threshold 数组，让不同区域的元素在不同相交比例时触发。

例如：首屏大图设 threshold: [0.1]（10% 进入即动），正文段落设 threshold: [0.3]，底部按钮设 threshold: [0.6]
每个元素可单独 new Observer，或用一个 Observer + entry.intersectionRatio 做条件分支
注意 threshold 是数组，不是单个数字，写成 [0.3] 而非 0.3（后者会被忽略）

CSS 滚动动画的复杂点不在 JS 或 CSS 单独哪一块，而在于三者咬合：Observer 的触发时机、CSS 动画的起始状态、以及不同设备视口尺寸对 rootMargin 的实际影响。少盯住其中一环，效果就容易断层。

本篇关于《CSS滚动动画：IntersectionObserver实战教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！