Bootstrap进度条需手动添加transition和JS控制才能实现动画效果:先为.progress-bar设置transition: width 0.6s ease-in-out和width: 0%,再用JS逐步更新width值及aria-valuenow属性。

Bootstrap 进度条默认不带动画,得手动触发
Bootstrap(v5.x)的 .progress-bar 本身只是静态样式容器,width 变化不会自动带过渡动画——除非你显式加 transition。很多人写完 style="width: 70%" 就以为会“动起来”,结果页面一刷新就直接卡在 70%,毫无加载感。
关键点在于:必须用 CSS 控制过渡行为,再配合 JS 动态改 width 值才能看到渐变效果。
- 给
.progress-bar加transition: width 0.6s ease-in-out(时间/缓动可调) - 初始状态建议设为
width: 0%,否则首次渲染可能跳变 - 别依赖
aria-valuenow自动驱动动画——它只是语义属性,不触发样式变化
用 JavaScript 逐步更新 width 实现“加载感”
纯 CSS 无法实现从 0 到目标值的分步填充,必须靠 JS 控制节奏。常见做法是用 setTimeout 或 requestAnimationFrame 递增 width,而不是一次性赋值。
示例(目标 85%):
const bar = document.querySelector('.progress-bar');
let width = 0;
const target = 85;
const timer = setInterval(() => {
width += 1;
bar.style.width = width + '%';
bar.setAttribute('aria-valuenow', width);
if (width >= target) clearInterval(timer);
}, 30);
- 间隔太短(如 10ms)容易卡顿;太长(如 100ms)显得迟滞,30–50ms 是较稳的选择
- 用
requestAnimationFrame更精准,但对简单进度条没必要过度优化 - 如果后端返回真实进度(如上传回调),就别用定时器,直接按回调值更新
width
Bootstrap 5 的 .progress-striped 和 .progress-animated 不等于“动态加载”
这两个类只是让背景条纹“滚动”,属于视觉装饰,和实际进度值无关。启用后你会看到条纹向右滑动,但 width 不变,用户完全感知不到加载进展。
-
.progress-striped:仅添加条纹背景图 -
.progress-animated:仅对条纹启用animation: progress-bar-stripes 1s linear infinite - 它们和
width动画互不干扰,可以共存,但别混淆功能
移动端或 SSR 场景下要注意 DOM 就绪时机
如果进度条在 Vue/React 组件里初始化,或页面由服务端渲染(SSR),document.querySelector 可能取不到元素,导致 JS 动画不触发。
- 确保 JS 在 DOM 挂载后执行,比如 Vue 的
mounted()、React 的useEffect(() => {}, []) - 用
document.addEventListener('DOMContentLoaded', ...)保底 - 避免在
中立即执行进度逻辑——那时.progress-bar还没生成
真正容易被忽略的是:动画是否在用户视口内启动。如果进度条初始在折叠区域(如 TabPane 或 Collapse 中),width 更新了但元素未渲染,动画就“静音”了——得监听显示状态后再激活。


















