横向进度条

用底轨和填充层呈现 0–256 的线性进度。

横向进度条是最轻的进度表达:一条底轨加一层填充,宽度按 256 步换算。它不带动画,也不读时钟;计时、加载或任务进度变化时,调用 set 就会立即重绘。

Rust
use aeris_ui::{
    device::progress_bar::ProgressBar,
    geometry::Rect,
    progress_ring::STEPS,
    theme::Color,
};

更改配置将自动应用并重载

基础用法
use aeris_ui::{
    device::progress_bar::ProgressBar,
    geometry::Rect,
    progress_ring::STEPS,
    theme::Color,
};

let area = Rect::new(8, 20, 320, 12);
let fill = Color::Accent.resolve();
if let Some(mut bar) = unsafe { ProgressBar::new(root, area, 0x2F2F2F, fill) } {
    bar.set(STEPS / 2);
}

area 同时决定位置、长度和粗细。圆角自动取高度的一半,所以 12 px 高的进度条两端是完整的半圆。

组件结构

组成说明
底轨与 area 等大的圆角矩形,颜色由调用方提供。
填充层从左侧开始,宽度按进度比例变化。
裁剪填充层被限制在底轨内部,超出部分不显示。

组件只有两个对象:底轨和填充。没有刻度、圆点或文字,复杂样式需要自己在外面叠加。

示例

跟随主题强调色

默认主色
use aeris_ui::{device::progress_bar::ProgressBar, geometry::Rect, theme::Color};

let fill = Color::Accent.resolve();
let bar = unsafe {
    ProgressBar::new(root, Rect::new(8, 20, 320, 12), 0x2F2F2F, fill)
};

Color::Accent 会读取当前主题覆盖值,没有覆盖时使用库的默认强调色。

更新颜色

运行中换色
bar.set_colors(0x2F2F2F, 0x5EE7FE);

底轨和填充色一起更新,不会重建对象。

映射业务进度

按剩余时间计算
let elapsed = total - remaining;
let steps = (elapsed as u32 * STEPS) / total.max(1);
bar.set(steps);

先把业务值换算到 0–256,再交给 set。组件只夹取上限,不做单位换算。

细进度条

4 px 高
let area = Rect::new(16, 40, 304, 4);

高度越小,圆角越小;4 px 时两端圆角为 2 px,适合作为卡片顶部的细分隔进度。

接口参考

ProgressBar::new

pub unsafe fn new(
    parent: Obj,
    area: Rect,
    track_color: u32,
    fill_color: u32,
) -> Option<Self>
参数类型说明
parentObj进度条挂载的父对象。
areaRect位置和尺寸,宽高必须大于 0。
track_coloru32底轨的 0xRRGGBB 色值。
fill_coloru32填充的 0xRRGGBB 色值。

宽或高为 0 时返回 None。

方法

方法返回值说明
set(steps)—设置 0–256 的进度;0 隐藏填充,超出上限按满格显示。
set_colors(track, fill)—同时更新底轨和填充颜色。

常量

常量值说明
STEPS256进度总数。

主题与样式

  • 填充色通常取 Color::Accent.resolve(),也可以传任意 0xRRGGBB。
  • 底轨色由调用方决定,示例使用 0x2F2F2F 作为深色底。
  • 组件不读主题,不会自动跟随强调色;换主题后需要重新调用 set_colors。
  • 圆角固定为高度的一半,不能单独设置。

交互与适配

  • 在 UI 线程创建和更新;父对象负责销毁。
  • 进度变化立即重绘,没有动画和逐帧成本。
  • area 的宽高必须大于 0,否则创建失败。
  • 进度超过 256 时按满格显示,不会报错。
  • 需要更明显的进度感时,改用进度环或计时卡。

相关组件

设备端入口:device::progress_bar::ProgressBar

大纲