Skip to content

滚动进度条

进度条会根据容器滚动距离实时填充,适合文章阅读进度、长页面浏览状态和文档导航提示。

实时预览

向下滚动查看进度条填充

向下滚动预览容器
进度条会同步填充
已到达底部

代码

html
<style>
  .progress-bar {
    position: fixed;
    top: 0;
    left: 0;
    height: 4px;
    width: 0%;
    background: linear-gradient(90deg, #667eea, #764ba2, #f093fb);
    background-size: 200% 100%;
    z-index: 9999;
    transition: width 0.1s linear;
    border-radius: 0 2px 2px 0;
  }
</style>

<div class="progress-bar" id="progress-bar"></div>

<script>
  const progressBar = document.getElementById('progress-bar');

  window.addEventListener('scroll', () => {
    const scrollTop = window.scrollY;
    const maxScroll = document.documentElement.scrollHeight - window.innerHeight;
    const progress = maxScroll > 0 ? (scrollTop / maxScroll) * 100 : 0;
    progressBar.style.width = progress + '%';
  });
</script>

滚动进度条滚动触发效果——元素在进入浏览器视口时触发 CSS transition 动画,从隐藏状态过渡到可见状态。配合 Intersection Observer API 实现视口检测,动画由 CSS 驱动,性能优异。

快速使用

  1. 复制 CSS 的初始状态和过渡样式到你的样式文件中
  2. 给需要滚动触发动画的元素添加初始类和 .scroll-target 样式
  3. 使用 Intersection Observer(或本站提供的 JS)在元素进入视口时添加 .visible
  4. 调整 transition 的持续时间和缓动函数以匹配你的页面节奏

使用场景

  • 首屏英雄区:页面加载后元素渐次出现,营造叙事节奏
  • 产品特性展示:每滚动到一个特性区块,触发不同的入场动画
  • 视差滚动:多层背景以不同速度滚动,营造深度感
  • 长篇文章/落地页:滚动进度条给用户阅读进度的心理预期

常见问题

Q: 滚动动画需要 JavaScript 吗? A: 本站滚动动画的演示版用少量 JS(Intersection Observer)检测元素进入视口。纯 CSS 方案可用 @scroll-timeline(Chrome 实验性支持),但生产环境建议用 Intersection Observer + CSS transition 组合。

Q: 如何控制滚动动画只播放一次? A: Intersection Observer 中设置 once: true 选项,元素进入视口后移除 observer。或者添加 class 后就永久保留,利用 CSS transition 的 forwards 填充模式。

Q: 移动端滚动动画卡顿怎么办? A: 确保动画属性只用 transformopacity;降低动画元素的复杂度(减少阴影、模糊等重效果);用 will-change: transform 提前提升合成层。

浏览器兼容性

浏览器兼容性
Chrome / Edge✅ 完全支持(Intersection Observer + CSS transition)
Firefox✅ 完全支持
Safari✅ 完全支持
移动端浏览器✅ 完全支持
IE 11❌ Intersection Observer 不支持,需 polyfill