标签仅表示已知范围内的完成度,需手动用 javascript 更新 value 值以反映真实进度;无进度数据时应使用 spinner 等加载指示器,而非强行使用 。

HTML <progress></progress> 标签本身不支持“加载中”语义
<progress></progress> 是一个表示**已知范围内的完成度**的语义化元素,它必须有明确的 max 和当前值(value)。浏览器不会自动识别或渲染“正在加载”的状态——如果你没设 value,它默认显示为 0%;如果你设了 value 但没更新,它就卡在那个值上。
常见错误现象:<progress max="100"></progress> 页面一打开就静止在 0%,用户完全看不出“请求发出去了”或“资源还在加载”。
真正需要“加载中”反馈时,你得自己控制状态流转:
- 初始:用 CSS 隐藏
<progress></progress>,或切换成<span>加载中...</span> - 开始请求:显示
<progress></progress>,并设value="0"(可选加动画) - 收到进度事件(如
XMLHttpRequest.upload.onprogress或fetch+ 流式读取):动态更新value - 完成/失败:设
value为max或隐藏/替换元素
用 <progress></progress> 做加载条必须配合 JavaScript 手动驱动
原生 <progress></progress> 不监听网络、不绑定 Promise、不感知 fetch 状态。它只是个“哑巴控件”,所有逻辑都得你写。
典型使用场景:文件上传、大资源分块加载、WebSocket 数据流接收。
示例关键片段:
<progress id="uploadProgress" max="100" value="0"></progress><script>
const progress = document.getElementById('uploadProgress');
const xhr = new XMLHttpRequest();
xhr.upload.onprogress = (e) => {
if (e.lengthComputable) {
const percent = (e.loaded / e.total) * 100;
progress.value = Math.round(percent); // 注意:value 必须是数字,不能是字符串
}
};
</script>
注意点:
-
value属性只接受数字,传字符串(如"50")会导致无效,浏览器可能回退到 0 - 不要直接改
innerHTML或用textContent操作<progress></progress>,它不渲染子内容 - 某些旧版 Safari 对
value动态更新有渲染延迟,可加requestAnimationFrame包裹
<progress></progress> 和纯 CSS 加载动画(如旋转 spinner)不是替代关系,而是分工不同
很多人混淆“进度条”和“加载指示器”:前者回答“完成了多少?”,后者回答“还在干活吗?”。<progress></progress> 只适合前者;当后端没返回任何进度信息(比如普通 fetch('/api') 没带 Content-Length 或服务端不发 Transfer-Encoding: chunked),你就根本拿不到 loaded/total,此时硬套 <progress></progress> 反而误导用户。
这时候该用 spinner:
- 用
<div class="spinner"></div>+ CSS@keyframes实现旋转动画 - 配合 ARIA:
role="status"+aria-live="polite"让屏幕阅读器知道“加载中” - 如果后续能拿到进度(如上传阶段切到进度条),再平滑切换 DOM,而不是复用同一个元素
性能影响很小,但兼容性更稳:spinner 在所有浏览器里都能立刻启动,<progress></progress> 的语义和样式在 IE10+ 才完整支持。
服务端没返回 Content-Length 时,前端几乎无法获得真实进度
这是最容易被忽略的底层限制。HTTP 响应头里如果没有 Content-Length,或者用了流式传输(Transfer-Encoding: chunked)且服务端没主动推送进度,那么 XMLHttpRequest 或 fetch 的 onprogress 回调压根不会触发,或者 e.lengthComputable 一直是 false。
这意味着:
- 你不能靠“只要写了
onprogress就一定有数”来设计 UI - 很多 REST API 默认不设
Content-Length,尤其是 JSON 响应由框架动态序列化生成时 - 真正可控的进度,往往只能出现在上传(
xhr.upload)、Service Worker 拦截响应、或后端主动推送(SSE/WebSocket)等少数路径
别把 <progress></progress> 当万能加载提示器。它有用,但前提是你手上有可计算的进度数据。没有,就老实用 spinner,别硬撑。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











