目录
2026年10月27日发布的Firefox 159默认启用了CSS滚动驱动动画。至此,所有主流浏览器的最新稳定版均已支持该功能,无需JavaScript滚动处理函数即可更轻松地实现阅读进度条和图片渐显效果。
要点#
- CSS滚动驱动动画将动画进度直接与滚动关联,因此反向滚动时,效果也会反向播放。
- 使用
scroll()跟踪滚动容器,使用view()跟踪元素穿过可视区域的过程。 - Chrome 115、Edge 115、Safari 26、Firefox 159及更高版本均已支持。
- 确保没有动画时内容仍可阅读,并尊重用户减少动态效果的设置。
对开发者有何改变#
普通CSS动画随时间推进。滚动驱动动画则随滚动位置推进:停止滚动时,动画也会停止;往回滚动时,动画会反向播放。
这与元素进入屏幕后开始并持续播放一定时间的效果不同。如果想通过视觉状态展示读者的当前位置,例如在可滚动页面的中点达到50%的进度条,就应选择滚动驱动动画。
这种实现还可以减轻主线程的处理负担。适合的动画可以在主线程之外运行,因此即使JavaScript处理繁忙,也更容易保持流畅。不过,并非所有效果都能保证如此。参与动画的属性和浏览器实现也会影响性能。
选择合适的时间线#
animation-timeline属性将@keyframes定义的动画与其进度依据关联起来。以下两个函数即可满足常见用途。
scroll()衡量滚动容器在可滚动距离内的滚动进度。view()衡量元素穿过最近滚动容器可视区域的过程。
页面整体的进度条使用scroll(block root)。root参数选择页面的根滚动容器,block选择块轴。在横排页面中,通常就是垂直方向。而不带参数的scroll()则使用最近的祖先滚动容器。
对于与单个元素关联的效果,例如图片随进入视口而逐渐显现,应使用view()。它的进度反映的是元素穿过可视区域的过程,而非读者在整个页面中的位置。
添加阅读进度条#
在长度足以滚动的页面中放置以下元素,并添加CSS。进度条从左端伸展,到达可滚动范围末尾时占满整个宽度。
<div id="progress" aria-hidden="true"></div>
<style>
#progress {
display: none;
}
@keyframes grow-progress {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
@supports (animation-timeline: scroll(block root)) {
@media (prefers-reduced-motion: no-preference) {
#progress {
display: block;
position: fixed;
top: 0;
left: 0;
z-index: 1000;
width: 100%;
height: 4px;
background: #06c;
transform-origin: left;
animation-name: grow-progress;
animation-duration: auto;
animation-timing-function: linear;
animation-timeline: scroll(block root);
}
}
}
</style>scaleX()在不改变文档布局的情况下改变进度条的视觉宽度。linear缓动函数使进度条长度与滚动进度成正比。进度条仅用于装饰,因此使用aria-hidden="true"将其从无障碍树中排除。
默认隐藏也很重要。如果浏览器不支持该时间线,或用户设置了减少动态效果,进度条将保持隐藏。
检查兼容性与无障碍支持#
根据提供的MDN兼容性数据,作为基础的animation-timeline、scroll-timeline和view-timeline属性已获得Chrome 115、Edge 115、Safari 26、Firefox 159及更高版本支持。随着Firefox此次发布,该功能达到Baseline Newly Available状态,可在Baseline涵盖的浏览器中使用。仍需兼顾旧版浏览器和嵌入式WebView。
请将动画视为附加功能。即使效果被禁用或不受支持,也应确保文字和图片可用。尤其要避免重要内容在回退情况下始终保持透明。
发布前,请检查以下4点。
- 来回滚动,确认动画与位置正确联动。
- 启用减少动态效果的设置,确认页面仍可正常使用。
- 禁用动画规则,测试回退效果。
- 在移动设备上检查滚动效果。尤其是在为transform和opacity以外的属性添加动画时,应格外注意。
下一步#
将上述进度条添加到长文章页面中,并在Firefox 159中确认滚动到页面底部时,进度条占满整个宽度。
来源: https://gihyo.jp/article/2026/10/css-scroll-driven-animations
目录
