应使用document.documentElement.scrollTop / (document.documentElement.scrollHeight - document.documentElement.clientHeight)计算滚动进度,该方法兼容sticky header、动态内容及overflow:hidden场景,并适配Safari与Chrome的scroll-behavior:smooth。

滚动条进度怎么算才准
直接用 window.scrollY / (document.body.scrollHeight - window.innerHeight) 算出来的值,在某些页面会偏高或跳变,尤其遇到 sticky header、动态插入内容、或者 overflow: hidden 的父容器时。根本原因是 scrollHeight 包含了不可见区域,而实际可滚动高度得剔除固定定位元素占位和 CSS transform 影响。
更稳的做法是用 document.documentElement.scrollHeight(取根元素)配合 document.documentElement.scrollTop,再减去 document.documentElement.clientHeight:
const progress = (document.documentElement.scrollTop) / (document.documentElement.scrollHeight - document.documentElement.clientHeight);
这个值始终在 0~1 之间,且兼容 Safari 和 Chrome 的 scroll-behavior: smooth 行为。
CSS 变量怎么实时更新不卡顿
别在 scroll 事件里直接写 document.documentElement.style.setProperty('--scroll-progress', progress) —— 频繁触发会导致样式重计算,尤其在低端机上明显掉帧。
用 requestAnimationFrame 节流 + 批量更新是必须的:
let isUpdating = false;<br>function updateProgress() {<br> if (isUpdating) return;<br> isUpdating = true;<br> requestAnimationFrame(() => {<br> const p = Math.min(1, Math.max(0, document.documentElement.scrollTop / (document.documentElement.scrollHeight - document.documentElement.clientHeight)));<br> document.documentElement.style.setProperty('--scroll-progress', p.toFixed(4));<br> isUpdating = false;<br> });<br>}<br>window.addEventListener('scroll', updateProgress);
注意:toFixed(4) 是为了减少字符串重复赋值;Math.min/max 防止因 DOM 尚未就绪导致的 NaN 或负值。
阅读指示器怎么用 CSS 变量驱动宽度动画
只靠 --scroll-progress 还不够,得配合 transition 和伪元素才能平滑显示。关键点有三个:
- 进度条必须用
::before或::after伪元素,避免影响文档流 -
width必须用calc()绑定变量,不能用width: var(--scroll-progress)(因为单位缺失) - 过渡要限定在
width上,否则颜色、阴影等其他属性也会动,拖慢渲染
示例 CSS:
body::before {<br> content: '';<br> position: fixed;<br> top: 0;<br> left: 0;<br> height: 4px;<br> width: calc(var(--scroll-progress) * 100%);<br> background: #3b82f6;<br> z-index: 9999;<br> transition: width 0.2s ease-out;<br>}
如果需要从左到右渐变色,可以用 background: linear-gradient(90deg, #3b82f6, #8b5cf6),但别加 transition: background —— 渐变色过渡在多数浏览器中不支持硬件加速,会卡。
移动端和 iframe 场景下为什么没反应
两个最常被忽略的坑:
- iFrame 内部滚动不会触发父页的
scroll事件,必须在 iframe 的contentWindow里单独监听,并通过postMessage向外同步进度值 - iOS Safari 默认禁用
body滚动,实际滚动容器是document.documentElement—— 所以你写的body.scrollTop在 iPhone 上永远是 0
判断是否在 iframe 中:
if (window.self !== window.top) {<br> // 需要监听 iframe.contentDocument.scrollingElement<br>}
判断 iOS 并修复滚动目标:
const scrollTarget = /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream<br> ? document.documentElement<br> : document.documentElement;
真机调试时,记得打开 Safari 的「开发者 → 当前页面」,用 console 查看 scrollTarget.scrollTop 实时值,比猜快得多。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











