Skip to page content

线性进度条

QLinearProgress 组件显示一个彩色加载条。该条可以显示确定的进度或不确定的动画。它适用于通知用户后台正在执行某个操作。

用法

确定状态

不确定状态

TIP

对于不确定状态(如上)或查询状态(如下),不需要指定 value 属性。

反转

样式

条纹



缓冲

缓冲



添加标签

要为进度条添加标签,可以使用默认插槽。请注意:

  • 使用足够大的 size 以确保标签能够显示
  • 为标签设置文本颜色,使其在已填充和未填充区域都清晰可见;或使用 text-shadow CSS;或使用 QBadge,如下例所示

无障碍访问
v2.25+

QLinearProgress 暴露 role="progressbar"aria-valuemin="0"aria-valuemax="1" 并将 aria-valuenow 设为当前值——注意范围是 0…1,与 value 属性一致。在 indeterminate(不确定)模式下(或 query 模式,动画方式相同),aria-valuenow 会被省略,符合规范要求。进度条本身没有无障碍名称,请添加 aria-label 来描述正在进行什么操作。