原生 Bootstrap 没有上传进度条是因为它仅提供 UI 样式(如 .progress 组件),不处理上传逻辑;进度数据需通过 XMLHttpRequest.upload.onprogress 事件手动获取并更新 DOM。

为什么原生 Bootstrap 没有上传进度条
Bootstrap 本身不提供文件上传进度跟踪能力,它只负责 UI 样式(比如 .progress 组件),而进度数据必须由 JavaScript 从 XMLHttpRequest 或 fetch 的上传事件中实时获取。直接套用 <div class="progress"> 不会自动动起来——你得自己把上传过程中的 <code>progress 事件和 DOM 更新连起来。
用 XMLHttpRequest 实现带进度的上传(兼容性好)
这是最稳妥的做法,尤其要支持 IE10+ 或需要细粒度控制时。关键点在于:必须用 XMLHttpRequest.upload.onprogress,而不是 XMLHttpRequest.onprogress(后者是下载事件)。
常见错误现象:event.loaded 和 event.total 都是 0,进度条不动——大概率是没监听 upload 对象,或者后端没返回 Content-Length(但上传进度其实不需要后端配合,只要不是分块编码且浏览器支持即可)。
实操建议:
- 创建
XMLHttpRequest实例,调用.open("POST", url),不要设.responseType(保持默认"") - 在
xhr.upload.onprogress = function(e) { ... }中计算百分比:Math.round((e.loaded / e.total) * 100) - 用
document.querySelector(".progress-bar").style.width = percent + "%"更新 Bootstrap 进度条宽度 - 记得在
xhr.onload后手动清空 input 的value(否则重复选同一文件不会触发change事件)
用 fetch + AbortController 替代(现代写法,但进度需额外处理)
fetch 原生不暴露上传进度,必须配合 ReadableStream 或第三方库(如 form-data + pipeTo)。对多数场景来说,不如 XMLHttpRequest 直接。但如果项目已全面用 fetch,可这样折中:
把文件转成 ArrayBuffer,再用 XMLHttpRequest 上传该 buffer(仍走 upload.onprogress),而其他请求继续用 fetch——二者不冲突。
性能影响:大文件(>100MB)转 ArrayBuffer 会吃内存;推荐流式读取(FileReader.readAsArrayBuffer 会等整个文件加载完才触发 onload),所以还是原生 XMLHttpRequest.send(file) 更轻量。
Bootstrap 进度条样式与交互细节
别忽略这些容易被跳过的点:
- 确保进度条容器有
height(Bootstrap 5 默认height: 0.5rem,太矮看不清动效,建议设为6px或8px) - 用
aria-valuenow和aria-valuemin/aria-valuemax更新属性,方便读屏软件识别 - 上传完成时,加个
.bg-success类并停在 100%,但别忘了重置状态:清除width、还原背景色、显示“上传成功”提示 - 禁用上传按钮期间,加上
disabled属性,否则用户可能狂点导致多个并发请求
复杂点往往不在逻辑,而在边界:文件为空、网络中断、服务端返回非 2xx 状态码时,进度条卡在 99% 却没报错——这时候 xhr.onerror 和 xhr.ontimeout 必须显式处理,并回退到初始状态。


















