For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/progress.md.
v0.0.57
  • 简体中文
  • Progress

    反馈@rockshin/tao-ui

    使用进度条、圆环或仪表盘弧线展示可量化进度。

    何时使用

    percent 应表达实际可测量的进度。为每个进度组件提供说明操作的无障碍标签。

    示例

    受控进度

    此本地示例以 10 为单位调整 percent。

    390 × 640
    TSX

    状态

    active 表示正在执行,exception 表示执行失败。

    45%
    TSX

    圆环与仪表盘

    仪表盘通过 gapDegree 和 gapPlacement 设置弧线缺口。

    75%
    75%
    TSX

    渐变与成功分段

    success.percent 表示总进度中已经成功完成的部分。

    80%
    85%
    75%
    TSX

    分段进度

    steps 适合固定数量的任务单元;圆环分段还可指定间距。

    60%
    70%
    TSX

    标签位置与格式

    可将标签放在进度条内部,或将百分比替换为任务单位。

    65%
    6 / 10 files
    TSX

    尺寸与语义样式

    数字尺寸用于条形高度或圆环直径;元组分别指定条形宽度和高度。

    55%
    55%
    55%
    TSX

    API

    Progress

    属性说明类型默认值
    className节点类名string | undefined-
    trailColor@deprecated Use railColor.string | undefined-
    width@deprecated Use size.number | undefined-
    style节点样式CSSProperties | undefined-
    gapPosition@deprecated Use gapPlacement.GapPosition | undefined-