结论先行:Scroll-Driven Animations(滚动驱动动画)用 animation-timeline 把 CSS 动画的进度绑定到滚动位置,替代「监听 scroll 事件再改样式」的传统做法,动画由浏览器在合成线程推进,不占主线程。随着 Firefox 159 于 2026 年 10 月 27 日默认启用,该特性正式进入 Baseline Newly Available(Chrome 115+、Safari 26+、Firefox 159+)。但存量旧浏览器仍不少,必须用 @supports 包裹并保证内容默认可见。本文覆盖滚动进度条、元素入场、视差三类实战与完整降级方案。
为什么滚动监听该退休了
「页面滚到哪,动画放到哪」是活动页和官网的常见需求:顶部阅读进度条、区块入场、视差背景。传统实现是监听 scroll 事件,读 scrollTop,算比例,再写 transform 或 opacity。问题有三:scroll 事件触发频率高,回调里读写几何容易触发强制同步布局;主线程繁忙时动画掉帧,滚动越快越明显;每个滚动容器都要单独挂监听,组件复用时监听泄漏是常客。IntersectionObserver 能解决「进入视口触发一次」的场景,但做不了「进度跟随」这种连续映射。
滚动驱动动画把映射关系声明化:你只写关键帧和时间线,浏览器负责把滚动偏移换算成动画进度。动画进度与滚动位置严格同步,回滚就倒放,不存在「状态没复位」的问题;合成器线程可以直接推进 transform、opacity 这类属性,主线程再忙也不影响跟手程度。代码量从几十行 JavaScript 缩到十几行 CSS,这是实打实的维护成本下降。
两种时间线:scroll() 与 view()
animation-timeline 接受两类时间线函数。scroll() 绑定「某个滚动容器的整体滚动进度」,参数是容器与轴:scroll(root block) 表示根滚动容器的块轴,scroll(nearest) 是最近的祖先滚动容器,scroll(self) 是元素自身。view() 绑定「元素在滚动视口中的可见进度」,从元素进入视口到完全离开为一个完整周期。前者适合进度条、全局视差,后者适合卡片入场、图片揭示。
时间线还可以命名复用:在滚动容器上声明 scroll-timeline-name: --page;,后代元素用 animation-timeline: --page; 引用;跨子树共享时用 timeline-scope 把名字提升到公共祖先。默认情况下动画时长被时间线接管,animation-duration 写 auto 即可,缓动建议用 linear,让进度与滚动严格线性对应,把「节奏感」交给关键帧本身而不是时间函数。
实战一:顶部阅读进度条
资讯站和长文页面最实用的增强。进度条固定在顶部,用 scaleX 表达进度,只动 transform,全程合成层:
.progress {
position: fixed;
inset: 0 0 auto 0;
height: 3px;
background: #5b47ff;
transform-origin: 0 50%;
transform: scaleX(0);
}
@supports (animation-timeline: scroll()) {
.progress {
animation: grow linear both;
animation-timeline: scroll(root block);
}
}
@keyframes grow {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}注意基线状态是 scaleX(0):不支持的浏览器里进度条静止在零宽度,等于不存在,不会留下半截色块。animation-fill-mode 用 both 而不是 forwards,保证回滚到顶部时进度也归零。整段没有一行 JavaScript,也没有任何监听器。
实战二:商品卡片入场与图片揭示
列表页希望卡片在进入视口时上浮淡入。用 view() 加 animation-range 精确控制「入场阶段」:
.card {
opacity: 1;
transform: none;
}
@supports (animation-timeline: view()) {
.card {
animation: rise linear both;
animation-timeline: view();
animation-range: entry 0% entry 60%;
}
}
@keyframes rise {
from { opacity: 0; transform: translateY(24px); }
to { opacity: 1; transform: translateY(0); }
}animation-range 的命名区间是这套 API 的精髓:entry 是「进入视口」阶段,exit 是「离开」阶段,contain 是「完全可见」阶段,cover 是全程。entry 0% entry 60% 表示卡片刚露头就开始动画,露出六成时完成,用户继续滚动时卡片已是稳定状态。想做「图片随滚动逐渐揭开」的效果,把关键帧换成 clip-path 从 inset(0 0 100% 0) 到 inset(0),时间线用 view(),区间用 cover 30% cover 70%,就是常见的杂志式揭示。基线样式里 opacity 恒为 1 是铁律:内容绝不能依赖动画才可见,否则旧浏览器用户看到的是空白页。
实战三:克制的视差与横向画廊
视差背景用 scroll() 驱动 translateY,幅度控制在几十像素内,避免大面积位移引发眩晕:关键帧从 translateY(-30px) 到 translateY(30px),时间线 scroll(root),区间 cover。横向滚动画廊则把时间线换成 scroll(self inline),让指示器或缩略图高亮跟随横向进度。需要提醒的是,视差属于「大面积物体以不同速度移动」的典型晕动诱因,务必在 prefers-reduced-motion: reduce 时整体关闭:把相关元素的 animation 置为 none,并恢复静态 transform。无障碍不是可选项,滚动动画尤其如此。
性能与调试要点
只动画 transform、opacity、clip-path、filter 这类可合成属性;用滚动时间线去动 width、top 会逼浏览器每帧重排,等于把优势全部吐回去。浏览器对滚动驱动动画有内建优化,不需要也不应该给一堆元素挂 will-change。还要强调内容可见性原则:滚动动画只能作为装饰层,正文、商品图片、价格这些关键信息必须在没有动画时就完整可见,这既是旧浏览器降级的要求,也是搜索引擎与读屏软件正确获取内容的前提。调试时 Chrome DevTools 的 Animations 面板可以识别滚动时间线,配合官方提供的 Scroll-driven Animations 可视化工具能直观看到 entry、contain、exit 各区间的边界。另一个常见坑是「动画不生效」:先检查滚动容器是否真的可滚动(overflow 与高度),再检查时间线名字的作用域,最后确认元素与滚动容器的祖先关系——view() 找的是最近的滚动祖先,中间隔了 overflow: hidden 的盒子就可能找错对象。
animation-range 的实战细节
区间写法决定动画的「手感」,几个经验值得固化。入场动画用 entry 区间且终点提前(如 entry 60%),让用户还没滚到元素正中时动画已完成,避免「边看边动」的干扰;揭示类效果用 cover 的中段(如 cover 30% cover 70%),把变化集中在元素位于视口中央的时段;离场淡出用 exit 区间,但要注意元素离开后动画停在终态,回滚时会倒放回来,这正是时间线相对一次性触发的优势。百分比也可以换成具体长度,如 animation-range: entry 0% entry 200px,表达「露头后 200 像素内完成」,在卡片高度不一的列表里比百分比更稳定。多个元素共用一条时间线时,用不同的区间错开节奏,就是零 JS 的交错动画;配合较新的 sibling-index() 函数还能按序号自动计算延迟,该函数 2026 年 8 月已进入 Baseline,可作增强使用。
兼容与降级策略
Chrome/Edge 115(2023 年 7 月)、Safari 26(2025 年 9 月)、Firefox 159(2026 年 10 月 27 日)先后落地,Baseline Newly Available 自 2026 年 10 月 27 日起算。这意味着「最新浏览器都有」,但 Firefox 158 及更早、Safari 18.x 及更早的存量用户仍会走降级分支,比例不可忽略。降级模式固定为三层:基线层内容完整可见;增强层整体包在 @supports (animation-timeline: scroll()) 内;reduce 层关闭动画。如果产品要求旧浏览器也有入场动画,可以在 @supports 不成立的分支里加载 IntersectionObserver 方案做一次性触发,但「进度跟随」类效果没有等价低成本替代,接受静态降级即可。
结合 api工厂:活动页与官网的滚动质感
H5 商城活动页是滚动驱动动画的高频场景:顶部活动进度、商品卡片依次入场、品牌 Banner 视差。用 api工厂(https://www.it120.cc/)搭建这类页面时,Banner 与商品数据在现成管理后台维护,前端用六端 SDK 拉取渲染,滚动增强层完全叠加在渲染结果之上,不与数据逻辑耦合。可以先到案例页(https://www.it120.cc/cases.html)看看真实商城与官网的结构,再把本文的进度条与入场代码贴进全局样式。由于增强层可整段删除,即使访客浏览器较旧,商城功能与内容展示也分毫不受影响——这正是渐进增强该有的样子。
命名时间线与 timeline-scope
匿名时间线函数够用大半场景,但组件库需要更可控的写法。命名时间线分两步:在滚动容器上声明 scroll-timeline-name(或 view-timeline-name),在动画元素上用 animation-timeline 引用这个名字。名字默认只在声明元素的后代里可见,如果动画元素与滚动容器分属两棵子树——比如吸顶进度条在 header 里、滚动容器是 main——就需要在公共祖先上声明 timeline-scope: --page; 把名字的作用域提升上来。这套机制与锚点定位的 anchor-scope 思路一致:名字是全局资源,作用域声明决定谁能看见谁。组件库建议统一命名规范,如 --scroll-page、--view-card,避免多个组件的时间线互相串扰。另外,view-timeline 也可以声明在「被观察元素」之外的参照元素上,实现「以 A 的可见进度驱动 B 的动画」这类联动,做章节导航高亮时非常好用。
与 IntersectionObserver 的分工
两者不是替代关系而是分工关系。IntersectionObserver 回答「是否进入视口」这个布尔问题,适合一次性触发:曝光埋点、懒加载、进入后播放一次的动画。滚动驱动动画回答「进度是多少」这个连续问题,适合跟随与倒放。判断标准很简单:效果需要随回滚复位吗?需要就用时间线,不需要就用观察器。混用时注意不要对同一元素同时挂两套 opacity 控制,观察器打的类名与时间线动画会互相覆盖。旧浏览器降级分支里用观察器做一次性入场是合理组合,但要在 @supports 成立的分支里把观察器逻辑跳过,避免双重动画。
常见失效清单
滚动动画不生效时按序检查:滚动容器是否真的可滚动,overflow 与高度缺一不可;animation-timeline 是否写在了正确的元素上,view() 找的是最近滚动祖先,中间隔了 overflow: hidden 的盒子就会找错;animation-range 的区间是否写反,entry 与 exit 的百分比方向容易搞混;关键帧是否只动了可合成属性,动了布局属性会被主线程拖累;最后确认 @supports 条件本身拼写正确,scroll() 与 view() 都要带括号。调试时把 animation-range 临时改成 cover 全程,能快速区分「时间线没接上」还是「区间设错了」。