滚动进度条不能仅用CSS实现，因fixed元素width:100%相对于视口而非页面总高度，必须用JS监听scroll事件，结合requestAnimationFrame节流、缓存scrollHeight、处理iOS Safari兼容性及边界情况动态更新宽度。

滚动进度条容器为什么不能直接用 position: fixed + width: 100%

因为 fixed 元素脱离文档流，width: 100% 是相对于视口宽度，不是页面总宽度；而滚动进度需要反映的是「当前滚动位置 / 页面总可滚动高度」，必须依赖 document.documentElement.scrollHeight 和 window.scrollY 计算，不能靠纯 CSS 驱动。

所以实际做法是：用 fixed 定位容器（保证始终在顶部），但内部进度条的宽度必须用 JS 动态更新。

• 容器设为 position: fixed; top: 0; left: 0; width: 100%; height: 2px;，背景透明或带色
• 内部 <div> 作为进度条，<code>position: absolute; top: 0; left: 0; height: 100%; width: 0%;
• JS 监听 scroll 事件，实时计算：window.scrollY / (document.documentElement.scrollHeight - window.innerHeight)
• 注意边界：当页面不可滚动（scrollHeight ≤ clientHeight）时，强制设为 0%，否则会 NaN 或负值

scroll 事件太频繁？别直接绑原生监听

原生 scroll 触发频率极高，尤其在 macOS 滚轮或触摸板上，每秒可能上百次。直接在里面算进度、改 style.width，容易卡顿或掉帧。

• 必须节流：用 requestAnimationFrame 包一层，确保每帧最多更新一次
• 避免重复读取 document.documentElement.scrollHeight —— 这个值在 DOM 变化时才变，可以缓存，滚动中不重读
• 不要用 debounce，它会延迟响应，用户快速滚动时进度条“追不上”
• 示例核心逻辑：

  let ticking = false;<br>function updateProgress() {<br>  const progress = Math.min(1, window.scrollY / (maxScrollHeight - window.innerHeight));<br>  progressBar.style.width = `${progress * 100}%`;<br>}<br>window.addEventListener('scroll', () => {<br>  if (!ticking) {<br>    requestAnimationFrame(() => {<br>      updateProgress();<br>      ticking = false;<br>    });<br>    ticking = true;<br>  }<br>});

移动端 Safari 的 scrollY 和 scrollHeight 不可靠？

iOS Safari 在地址栏收起/展开时会触发 resize，但 window.innerHeight 变了，scrollY 却没同步更新，导致进度跳变甚至倒退。这不是 bug，是它的 UI 行为。


CSS婚礼策划服务机构宣传网站模板
CSS婚礼策划服务机构宣传网站模板是一款适合提供婚礼策划和婚庆服务机构宣传网站模板下载。提示：本模板调用到谷歌字体库，可能会出现页面打开比较缓慢。
下载

立即学习“前端免费学习笔记（深入）”；

• 必须监听 resize 事件，重新校准 maxScrollHeight 缓存值
• 不要依赖 document.body.scrollHeight —— 在某些文档模式下它为 0，一律用 document.documentElement.scrollHeight
• 滚动到最底时，scrollY 可能略大于理论最大值（Safari 惯性滚动超限），需用 Math.min(scrollY, maxScrollHeight - innerHeight) 截断
• 如果页面有 transform: translateZ(0) 或 will-change，可能影响滚动容器层级，导致 fixed 条被遮挡 —— 检查父级是否有 overflow: hidden 或 transform

要不要用 IntersectionObserver 替代 scroll 监听？

不用。IntersectionObserver 用于元素进出视口，无法获取精确滚动比例，也不响应滚动过程中的连续位置变化。它适合“滚动到某区域触发动画”，不适合“滚动进度条”这种需要亚像素精度的场景。

• 想省事用库？scrollmonitor 或 locomotive-scroll 都是封装了 RAF 节流 + 兼容处理的，但引入整包有点重
• 真要零依赖，上面那个 requestAnimationFrame + 缓存 + 边界处理的组合，30 行内搞定，维护成本低
• 最容易被忽略的一点：CSS 中给进度条加 transition: width 0.1s linear;，不然宽度突变会闪，但过渡时间别超过 0.2s，否则滞后感明显

事情说清了就结束。