目录

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。进度条从左端伸展,到达可滚动范围末尾时占满整个宽度。

snippet.txt
<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

目录