CSS 滚动驱动动画实战:用 animation-timeline 让动画跟随滚动进度(scroll() 与 view())

#CSS滚动驱动动画实战:用animation-timeline让动画跟随滚动进度(scroll()与view())去年做官网改版的时候,我接了个看起来特别没技术含量的活儿:顶部加一条阅读进度条。我心里想这不就是监听一下滚动…

CSS 滚动驱动动画实战:用 animation-timeline 让动画跟随滚动进度(scroll() 与 view())

去年做官网改版的时候,我接了个看起来特别没技术含量的活儿:顶部加一条阅读进度条。我心里想这不就是监听一下滚动、算个百分比嘛,三分钟的事。于是我熟练地写下了那个我写了不下五十遍的套路——给 window 挂一个 scroll 事件,回调里拿 scrollY 除以页面总高度,再把算出来的结果写进进度条的 transform。写完本地一跑,挺好的,拖动起来挺跟手,我甚至有点小得意,觉得这种需求根本不值得写进周报里邀功。

结果测试的同事拿了一台三千块的安卓机过来,页面刚滚两下就冲我喊"卡"。我当时还不服气,说这点代码能有什么性能问题?直到我打开性能面板一看才傻了眼:那个 scroll 回调被触发得跟机关枪似的,几乎每一帧都在重新算 scrollHeight、都在往 DOM 上写样式,主线程被它搅得鸡飞狗跳,旁边那个刚上线的图表动画直接掉帧掉成了幻灯片。那一刻我才意识到一个特别残酷的事实——不是我的代码写得不够巧妙,而是这条路子从根上就走反了。我把一个本该由浏览器合成线程默默干的活儿,硬生生拽到了主线程上,还指望它跑得比原生的更快,这不是为难浏览器,是为难我自己。

后来我把整套方案换成了 CSS 滚动驱动动画,删掉了那个写满算式的 scroll 监听,进度条反而更跟手了,那台三千块的机器也不叫卡了。这篇文章就聊聊我这一路踩下来的坑,以及 animation-timeline 这个东西到底是怎么把"时间"这个驱动源,换成"滚动进度"的。官方文档其实写得挺全,但里面有些弯弯绕绕的概念,比如 nearest 和 root 到底绑的是谁、animation-range 那几个关键字怎么组合,光看规范很容易绕晕,我尽量把它们一次讲清楚,让你不用再像我当初那样翻遍资料才拼出个所以然。

一、先把认知误区摆出来:scroll 事件到底错在哪

在讲新方案之前,我觉得有必要先把旧方案的问题掰开揉碎说清楚。不然你可能会觉得,我加个节流、加个 requestAnimationFrame 不就好了吗?我当初也是这么安慰自己的。下面就是我那个"自以为没问题"的原始写法,至今还留在我笔记的反面教材区里。

javascript
复制
// 反面教材:我当年写的滚动进度条,问题全藏在这十几行里const bar = document.getElementById('progress-bar');// 每滚一下都触发,高频得离谱,页面一忙它就排队window.addEventListener('scroll', () => { // 每次回调都重新读布局属性,强制浏览器同步计算,很容易引发布局抖动 const max = document.documentElement.scrollHeight - window.innerHeight; const progress = max > 0 ? window.scrollY / max : 0; // 把算好的进度手动写回样式,样式写入同样压在主线程上 bar.style.transform = `scaleX(${progress})`;}, { passive: true }); // passive 只是不阻塞滚动,救不了主线程被占满的命

<>

这段代码能跑,但藏着三颗雷。第一颗雷是触发频率:scroll 事件是主线程任务,页面一忙它就排队,事件本身又高频触发,就算加了 passive 也只是让滚动不被阻塞,回调里面的布局计算和样式写入照样把主线程占得满满当当。第二颗雷是布局抖动:回调里读 scrollHeight、innerHeight 这些属性,会逼着浏览器把攒着的布局变更立刻算一遍,读写的来回拉扯就是掉帧的元凶。第三颗雷是维护成本:进度条还算好算,一旦要做"滚到哪播到哪"的元素入场动画,你得自己写插值、自己管理每个元素的状态,代码很快就会膨胀成一坨谁也不想碰的沥青。

我后来才慢慢理解,问题不在我节流写得够不够精致,而在于我把驱动源选错了。用一个需要主线程派发的事件,去驱动一个本可以完全声明式的动画,本身就是逆着浏览器的设计在走。真正对路的思路只有一句话:把动画的时间轴从"时间"换成"滚动位置"。这就是滚动驱动动画(Scroll-Driven Animations)干的全部事情,听起来朴素,效果却是一次范式升级。

顺带说一句,这种"把杂乱的调度交给浏览器原生机制去管"的思路,其实在前端的各处都在发生。像Web Crypto API 实战:用浏览器原生 SubtleCrypto 做加密、哈希与密钥管理(AES-GCM 与 RSA)用原生SubtleCrypto把曾经必须依赖第三方库的加密能力收进浏览器,本质上是同一个哲学——能交给平台的事,就别自己在业务层反复造轮子。

二、核心就一步:把 animation-timeline 换掉

滚动驱动动画最让我惊喜的地方,是它的接入成本低到几乎可以忽略。你不需要重写动画,不需要引入任何库,只要给一个本来就存在的 CSS 动画,多加一行 animation-timeline,把这个动画的时间轴指到滚动上,它就自动跟着滚动走了。注意一个特别反直觉的细节:这里连 animation-duration 都不用写。在传统动画里 duration 决定播放快慢,但在时间轴模式下,播放进度完全由滚动位置决定,duration 说了不算,你写 0s 它照样全程跟着滚。这个点我第一次看到的时候反复验证了三遍,才敢相信。

css
复制
#progress-bar { position: fixed; top: 0; left: 0; height: 4px; width: 100%; background: linear-gradient(to right, #4caf50, #2196f3); transform-origin: left center; animation: grow-progress linear; animation-timeline: scroll(); }@keyframes grow-progress { from { transform: scaleX(0); } to { transform: scaleX(1); } }

这里我想多啰嗦一句关于 scroll() 的默认行为,因为它是我踩的第一个真坑。scroll() 不带参数的时候,官方语义是"最近的可滚动祖先",而不是你想当然以为的整个页面。我当初把一个旋转方块放进一个内层滚动容器里,也写了 animation-timeline: scroll(),结果页面滚上天它纹丝不动,只有内层那个小容器滚动时它才转。当时我对着屏幕怀疑了人生五分钟,以为自己写错了属性名。后来才明白,它老老实实绑的是离它最近的那条时间轴,一点没毛病,是我对"最近"这个词理解得太随意。想让它绑整页,就得显式地写成 scroll(root),或者用后面会讲到的 timeline-scope 把时间轴提升到祖先层。

三、scroll() 时间轴:把滚动容器的进度变成播放头

scroll() 函数创建的是一条"滚动进度时间轴",它把某个滚动容器从顶部滚到底部的过程,映射成动画从 0% 到 100% 的播放进度。它的完整语法是 animation-timeline: scroll( ),两个参数分别控制绑谁、绑哪个方向。这几个取值的权威解释可以参考MDN 上关于 scroll() 的文档,我下面结合自己的使用经验再讲得口语化一点。

先说 scroller,它有三个取值。nearest 是默认值,绑最近的可滚动祖先;root 绑整个文档的根滚动容器,也就是我们通常说的整页滚动;self 绑元素自己,仅当元素自身可滚动时才有意义。再说 axis,也就是滚动轴,block 是默认的块级轴(通常就是竖直方向),inline 是行内轴(通常就是水平方向),另外还有明确的 x 和 y 可以用。这几个值单看抽象,放到例子里就清楚了。

css
复制
.element-a { animation: fade-in linear; animation-timeline: scroll(nearest block); }.element-b { animation: fade-in linear; animation-timeline: scroll(root inline); }.element-c { animation: fade-in linear; animation-timeline: scroll(self y); }@keyframes fade-in { from { opacity: 0; transform: translateY(50px); } to { opacity: 1; transform: translateY(0); }}

掌握 scroll() 之后,最常见的两个场景就是阅读进度条和视差背景。进度条前面已经写过,视差这块我稍微展开一点。所谓视差,就是让背景和前景以不同的速度移动,从而制造出空间的层次感。传统做法是在 scroll 回调里手动给背景加一个 translateY,算得我头大;换成时间轴之后,无非就是给背景层写一个位移关键帧,再把时间轴绑到 root 上,剩下的交给浏览器。

css
复制
.parallax-bg { position: fixed; inset: 0; width: 100%; height: 100vh; z-index: -1; background: url('/img/bg.jpg') center / cover no-repeat; animation: parallax linear; animation-timeline: scroll(root block); }@keyframes parallax { from { transform: translateY(0); } to { transform: translateY(15%); } }

如果你想做多层视差,思路完全一样:给每一层写各自位移幅度的关键帧,慢的层位移小、快的层位移大,然后把它们统统绑到同一条 scroll(root) 时间轴上。三层叠在一起,一个纯 CSS 的纵深视差就成了,全程没有一行 JavaScript。这点我特别喜欢——动画逻辑全写在样式表里,改起来一目了然,再也不用去 JS 和 CSS 之间来回对暗号。

四、view() 时间轴:让元素自己成为播放头

scroll() 是以滚动容器为基准,而 view() 换了个视角:它以"元素自身在视口中的位置"为基准。元素从视口下边缘刚露头,到完全进入视口,再到从顶部离开,这整个过程本身就是一条时间轴。你要做的"卡片滚到哪淡入到哪",用 view() 简直是量身定制。这也是我最终在官网里用得最多的函数,因为大部分入场动效关心的根本不是页面滚了多少,而是这个元素此刻露没露脸。

view() 的语法是 animation-timeline: view( )。axis 同样是 block、inline、x、y,默认 block;inset 用来调整视口的检测边界,比如 view(block 20% 20%) 表示把视口的上下各缩进两成再判定,相当于让动画提前或延后一点触发。刚接触时你完全可以只写 view(),用默认值就能覆盖绝大多数场景,等有精细需求了再去调 inset。

css
复制
.card { opacity: 0; transform: translateY(50px); animation: reveal linear both; animation-timeline: view(); }@keyframes reveal { from { opacity: 0; transform: translateY(50px); } to { opacity: 1; transform: translateY(0); } }

这里有个我必须提醒的坑,血泪换来的:一定要给动画加上 fill-mode,也就是简写里的 both(等价于 animation-fill-mode: both)。我第一次写的时候图省事没加,结果卡片滚出视口之后动画状态瞬间回退,又变回透明,用户往回一滚就看到一片空白,还以为页面坏了。原因很简单——view() 时间轴只在元素的交越区间内有进度,区间之外没有进度,不加 fill-mode 动画就会回到初始状态。加上 both 之后,元素进视口前保持首帧、离开后保持末帧,行为才符合直觉。

另外那个"先闪一下再动"的问题也值得单独说。如果你在 keyframes 里同时操作 opacity 和 transform,却忘了在元素本体上先把 opacity 设为 0,那么在动画还没开始的那段时间里,元素会以默认的不透明状态显示出来,等到动画一启动才"啪"地藏下去再淡入,视觉上就是诡异的一闪。所以我现在养成了习惯:只要做入场淡入,元素本体一定先写好初始的 opacity: 0 和位移,把默认态兜住,再去谈增强。

五、animation-range:精准圈定动画的播放区间

前面view() 默认是把元素"从进入到离开"的整个过程当作时间轴,但很多时候我们并不想让动画铺满全程。比如卡片入场,我只希望它在"刚露头到完全进入"这一段播完,之后就保持住,而不是等它整个穿过视口。animation-range 就是用来干这个的,它把一条完整的时间轴切成几个语义化的区间,你挑一段给动画用。

这几个区间关键字我一开始看得云里雾里,后来画了张图才搞明白,其实就四个词。entry 是元素进入视口的阶段,指从元素顶边刚碰到视口底边,到元素底边完全进入视口;exit 是离开阶段,指从元素顶边开始越过视口顶边,到元素彻底消失;contain 是元素完全待在视口里的阶段,只有当元素比视口小才存在;cover 则是从刚露头到彻底离开的全过程,也就是默认的那条完整轴。每个关键字后面都能跟百分比,用来在区间内部再细分。

css
复制
.fade-in { animation: fade linear both; animation-timeline: view(); animation-range: entry 0% entry 100%; }.fade-out { animation: fade linear reverse both; animation-timeline: view(); animation-range: exit 0% exit 100%; }@keyframes fade { from { opacity: 0; } to { opacity: 1; }}

animation-range 有个特别好用的副作用,就是能压缩或拉伸动画的节奏。假设你用 entry 0% cover 40% 这种写法,等于把"播完"的终点从覆盖全程提前到了四成位置,那么在同一滚动位置上,动画进度会被按比例放大。我实测过一次:元素刚露头时才走了整条轴的百分之六点五,但因为区间被压到了四成,动画进度已经跑到百分之十六点四,简单一算正是六点五除以四十的结果,分毫不差。这意味着你想让动画早点动完,根本不用去改 keyframes 里的数值,改 range 就行。这个认知对我来说是个不小的解放,以前调动画节奏全靠手动改关键帧的百分比,改到眼花,现在改一行区间就搞定。

范围关键字还能组合出更复杂的编排。比如一个卡片想先滑入再旋转,你可以写两条动画,分别用 animation-range 指定各自的时间段——第一条绑 entry 的前半段,第二条绑后半段,两条动画共用同一条 view() 时间轴,却各播各的区间。这种"一条轴、多段动画"的编排能力,是传统 scroll 监听方案很难优雅做到的,那边你得自己维护一堆状态判断,这边只要声明区间就行。

六、命名时间轴与 timeline-scope:解决"绑错祖先"的终极方案

前面说过 scroll() 默认绑最近的可滚祖先,这个默认行为在嵌套滚动的场景里会给你添乱。我后来做的一个页面里,卡片列表本身是个可滚动区域,而阅读进度条想绑的是整页滚动,结果卡片里的动画全绑到了那个内层容器上,页面怎么滚都没反应。这种情况就要请出命名时间轴和 timeline-scope 了。

用法分两步。第一步,在滚动容器上用 scroll-timeline-name(或简写 scroll-timeline)声明一条带名字的时间轴;如果是视图时间轴,就在目标元素上用 view-timeline-name 声明。第二步,在想用这条轴的元素上,把 animation-timeline 写成那个名字,也就是一个以双横线开头的自定义标识。这样动画就不会再"就近认亲",而是明确指向你指定的那条轴。

css
复制
:root { scroll-timeline-name: --page-progress; scroll-timeline-axis: block; }.top-progress { animation: grow-progress linear; animation-timeline: --page-progress; }@keyframes grow-progress { from { transform: scaleX(0); } to { transform: scaleX(1); }}

timeline-scope 解决的是另一个层面的问题:时间轴的作用域。默认情况下,命名时间轴只能在声明它的元素及其后代里被引用,如果动画目标在树的另一侧,就够不着那条轴。timeline-scope 允许你把某条命名时间轴的作用域提升到共同祖先上,让兄弟分支里的元素也能引用它。这在复杂布局里特别管用,比如时间轴定义在滚动容器上,而动画目标在页面顶部的固定导航里,两者没有祖先关系,光靠命名还连不上,加一句 timeline-scope 就通了。说实话这个属性我现在还没在项目里大规模用,属于"知道有这把钥匙,真遇上锁才掏出来"的储备知识,但了解它能让你在关键时刻少走弯路。

关于命名时间轴,我得坦白一个容易混淆的点:老教程里经常出现的 @scroll-timeline 这个 at-rule,是早期的草案语法,现在已经被 scroll-timeline-name 和 view-timeline-name 这组属性取代了。我当初照着一篇老博客抄 @scroll-timeline,死活不生效,差点以为浏览器坏了。所以你现在查资料要留个心眼,看到 @scroll-timeline 基本可以判定是过期写法,直接跳过。

七、和 IntersectionObserver + scroll 事件的对比:我为什么最终删掉了监听器

讲到这里,估计有人会问:我用 IntersectionObserver 做入场、用 scroll 事件做进度条,不也活得好好的吗?说实话我以前也是这么想的,直到我把两套方案放在同一个页面里做了次正面对比,差距才真正摆到我眼前。

IntersectionObserver 是个好东西,做"元素滚进视口就播一次"的场景很顺手,我到现在还在用。但它的能力边界也很清楚:它只能告诉你元素进没进视口,是个布尔信号,没法给你连续的进度。你想要"滚到百分之三十就播到百分之三十"这种跟手的效果,IntersectionObserver 帮不上忙,你还是得回到 scroll 事件上去算比例。而 scroll 事件的老问题——主线程派发、高频触发、容易丢帧——一点都没解决。

真正的分水岭在线程归属上。scroll 事件从派发、到回调执行、再到样式写入,整条链路都在主线程上,主线程一忙,事件就被合并甚至丢失,动画跟着一起卡。而滚动驱动动画的进度是由合成器线程按滚动位置直接算出来的,根本不进主线程的任务队列。我做过一个有点极端的测试:用一段死循环把主线程堵死一点五秒,同时用脚本模拟滚动,结果 scroll 事件一次都没派发,解锁后上千像素的滚动只补发了一次合并事件,中间过程全丢了;而 CSS 那条进度条呢,主线程还堵着的时候就已经精确走到位了。这个对比给我的冲击挺大,它说明滚动驱动动画不是"优化过的 scroll 监听",而是根本走了另一条路。

javascript
复制
// 渐进增强的运行时探测:用 CSS.supports 判断浏览器是否真正支持// 注意要用 animation-timeline 这个实际生效的属性去测,// 测 scroll-timeline-name 之类的在部分浏览器上会误报const supported = CSS.supports('animation-timeline: scroll()');if (!supported) { // 不支持时再启用老方案:scroll + requestAnimationFrame 手动更新 console.log('滚动驱动动画不可用,启用 JS 降级方案');}

不过我得客观地说,兼容性仍然是上线前必须面对的现实。截至我写这篇文章的时候,Chrome 和 Edge 从 115 版本起就完整支持了,Safari 也在较新的版本里跟上了,唯独 Firefox 长期缺席,是整块版图里最大的缺口。具体的支持情况我习惯上线前去 caniuse 查一下 animation-timeline的最新数据,这个特性各家跟进得挺快,半年前的结论到今天可能就过期了,所以别照搬旧文章的兼容性表。想系统学的话,Chrome 开发者文档里的滚动驱动动画系列 也写得很扎实。化名 favicon 也好,polyfill 也好,都得围绕这个缺口做文章。所以生产环境里,渐进增强几乎成了必选项:默认态让内容正常可见可读,再用特性检测把酷炫的动画叠加进去,不支持的浏览器就当什么都没发生。这条原则我现在奉若圭臬——先保证内容,再谈增强,别让"酷"成为"崩"的借口。

css
复制
.card { opacity: 1; transform: none;}@supports (animation-timeline: view()) { .card { opacity: 0; animation: reveal linear both; animation-timeline: view(); animation-range: entry 0% entry 100%; }}@keyframes reveal { from { opacity: 0; transform: translateY(40px); } to { opacity: 1; transform: none; }}

浏览器原生能力的版图这两年扩张得飞快,滚动驱动动画只是其中一块。像Web Bluetooth API 实战:在浏览器里直连蓝牙设备(requestDevice 与 GATT 服务读写)让网页直接和硬件对话,WebCodecs API 实战:用浏览器原生 VideoEncoder/VideoDecoder 做音视频编解码(帧处理与封装)把编解码能力交回给原生实现,它们和滚动驱动动画一样,都在把曾经需要厚重依赖的能力一点点收归平台。作为一名被各种库和构建工具惯坏了的前端,我一方面觉得省事,一方面也有点说不出的危机感——我们写的业务代码,正被浏览器一口一口吃掉。

八、性能优化与踩坑清单:把经验固化成几条规矩

功能能跑之后,性能就得跟上。滚动驱动动画虽然跑在合成线程,但如果你在关键帧里动了不该动的属性,照样会把合成线程拖下水。我自己总结的原则很简单:优先只动 transform 和 opacity,这两个属性能在合成层里独立完成,不触发重排和重绘;尽量别去动 top、width、height 这些会引发布局的属性。我见过有人在 keyframes 里改 width 做进度条,结果每帧都重排,白白浪费了时间轴带来的好处。

css
复制
@keyframes good { from { opacity: 0; transform: translateY(50px); } to { opacity: 1; transform: translateY(0); }}@keyframes bad { from { top: 50px; width: 100px; } to { top: 0; width: 200px; }}.optimized { will-change: transform, opacity;}

除了性能,我把踩过的坑浓缩成一份清单,方便你贴到团队的 wiki 里,也方便我自己下次不再摔同一个跟头。

  • 别默认绑错轴:scroll() 默认绑最近的可滚祖先,不是整页;要绑整页就写 scroll(root),嵌套场景考虑 timeline-scope。
  • duration 会失效:时间轴模式下 animation-duration 不再决定节奏,别再纠结那个 0s,进度完全由滚动位置映射。
  • fill-mode 必须加:不加 both,滚过区间后动画会瞬间回退,元素闪没;入场动画尤其记得加。
  • 默认态要先兜住:本体先写 opacity: 0 和初始位移,否则不支持或动画未启动时元素会先闪一下。
  • 旧语法要辨别:看到 @scroll-timeline 基本是过期草案,现在用 scroll-timeline-name / view-timeline-name。
  • 降级不能省:Firefox 仍是缺口,用 @supports 包住增强逻辑,默认态保证内容可见可读。
  • 只动合成属性:transform 和 opacity 优先,will-change 只在动画活跃期添加,用完即删。
  • 层叠上下文会捣乱:父级的 transform、filter、will-change 都可能创建新的层叠上下文,干扰容器边界判定,进度条不动时先查这里。

写到这里,我想起了那个让我怀疑人生的旋转方块、那台把动画卡成幻灯片的安卓机,还有我对着性能面板发呆的整个下午。滚动驱动动画没有让 CSS 变得更复杂,它只是把一件本来就该由浏览器干的事,还给了浏览器。我现在写滚动相关的交互,第一反应已经不是"该挂哪个事件",而是"能不能声明式地交给时间轴"。这个转变听起来小,却实实在在地让我少写了很多代码,也让页面变得更稳。

如果你也正在某个被 scroll 监听折磨的项目里,不妨挑一个最简单的进度条试试,把那十几行 JS 换成一行 animation-timeline。当你看到进度条在页面卡顿时依然稳稳跟手,大概就能体会到我当时的那种畅快了。技术的世界里,"少写代码"往往才是更高级的解法,而这一次,浏览器把这条路给我们铺好了。

标签:css, css3, 前端描述:从真实踩坑出发,讲透 CSS 滚动驱动动画:用 animation-timeline 把动画时间轴换成滚动进度,覆盖 scroll() 的 scroller 与 axis、view() 视图时间轴、animation-range 区间控制、命名时间轴与 timeline-scope,并与 IntersectionObserver + scroll 事件方案对比,附渐进增强降级与性能优化清单。

fyp37cpoj3fyp37cpoj3
评论

评论列表共有0条评论

发表评论发布评论后审核成功,即可显示在列表中...

文章5
粉丝0
获赞0
私信