原生javascript实现真实加载进度条需分三阶段加权计算:html解析(30%)、关键css/js(40%)、图片字体等(30%),监听document.readystate变化与资源load/error事件,用requestanimationframe平滑更新dom宽度,禁用progress标签改用transform缩放避免兼容性问题。

如何用原生 JavaScript 实现页面加载进度条
纯 CSS + JS 实现的进度条,不依赖第三方库,能真实反映 document.readyState 和资源加载状态。关键不是“动起来”,而是让进度值和实际加载节奏匹配,否则会误导用户。
常见错误是只监听 DOMContentLoaded 或简单用定时器模拟——前者无法反映图片、字体等资源加载,后者纯属假进度。
- 监听
document.onreadystatechange获取初始 HTML 解析阶段(loading→interactive→complete) - 对
document.querySelectorAll('img, link[rel="stylesheet"], script')中每个资源,绑定load和error事件,动态更新完成计数 - 避免重复绑定:用
dataset.loaded = "true"标记已处理元素,防止img重载或多次插入触发重复计数
为什么不能只靠 window.addEventListener('load', ...)
window.load 确实表示所有资源就绪,但它是终点信号,没法提供中间进度。用户在白屏阶段看不到任何反馈,体验断层。
更糟的是,某些资源(如异步 script、懒加载 img)可能根本不会阻塞 window.load,导致进度条卡在 90% 不动。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
-
window.load触发时进度应已是 100%,不能用它驱动进度更新逻辑 - 必须拆解为:HTML 解析(30%)、关键 CSS/JS 加载(40%)、图片/字体等非阻塞资源(30%)三段加权估算
- 权重需手动配置,例如
img占比高则设为 0.5,否则默认按数量均分
requestAnimationFrame 更新进度条的必要性
直接用 element.style.width = percent + '%' 在循环中频繁修改样式,会触发大量强制同步布局(layout thrashing),尤其低端设备明显掉帧。
用 requestAnimationFrame 把更新收敛到下一帧,既平滑又省资源:
function updateBar(percentage) {
rafId && cancelAnimationFrame(rafId);
rafId = requestAnimationFrame(() => {
progressBar.style.width = Math.min(percentage, 99) + '%'; // 留 1% 防止过早显示完成
});
}
- 不要在
load事件里直接设 100%,先设 99%,等requestAnimationFrame下一帧再补满,避免视觉跳变 - 如果进度计算快于渲染帧率(比如瞬间从 10% 到 80%),
requestAnimationFrame自动合并为单次更新,比setTimeout(..., 0)更可靠
移动端 Safari 下 progress 元素兼容性陷阱
别用原生 <progress></progress> 标签——iOS 15.4 之前不支持自定义样式,且无法通过 JS 精确控制 value(内部四舍五入到整数),导致 37.6% 显示成 38%,误差累积后跳变明显。
稳妥做法是用 <div class="progress-bar"><div class="progress-fill"></div></div> 结构,纯 CSS 控制宽度。
- CSS 中禁用
transition: width 300ms ease,改用transform: scaleX()触发 GPU 加速,避免重排 - 务必设置
overflow: hidden在外层容器,防止 fill 宽度超限时溢出 - Android WebView 对
will-change: transform支持不稳定,仅在 iOS 上启用该优化
font-display: swap 还是 block?这些都会显著改变进度曲线形状。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










