QLinearProgress 组件显示一个彩色加载条。该条可以显示确定的进度或不确定的动画。它适用于通知用户后台正在执行某个操作。
用法
确定状态
不确定状态
TIP
对于不确定状态(如上)或查询状态(如下),不需要指定 value 属性。
反转
样式
缓冲
添加标签
要为进度条添加标签,可以使用默认插槽。请注意:
- 使用足够大的
size以确保标签能够显示 - 为标签设置文本颜色,使其在已填充和未填充区域都清晰可见;或使用
text-shadowCSS;或使用 QBadge,如下例所示
无障碍访问 v2.25+
QLinearProgress 暴露 role="progressbar",aria-valuemin="0"、aria-valuemax="1" 并将 aria-valuenow 设为当前值——注意范围是 0…1,与 value 属性一致。在 indeterminate(不确定)模式下(或 query 模式,动画方式相同),aria-valuenow 会被省略,符合规范要求。进度条本身没有无障碍名称,请添加 aria-label 来描述正在进行什么操作。