Progress

Progress 用一条填充轨道展示确定性进度,如下载、上传或多步任务。下方预览由 pingo 引擎实时渲染,并跟随站点主题切换明暗。

用法

import { Progress } from "@dopejs/pingo-ui";

root.render(<Progress value={60} />);

轨道宽度继承父容器,把 Progress 放在一个固定宽度的容器里即可控制条长:

<container width={320}>
  <Progress value={60} />
</container>

示例

自定义最大值

max 默认 100。传入后按 value / max 计算填充百分比,并始终钳制在 0–100 之间:

<Progress value={3} max={10} /> // 30%

Props

Prop 类型 默认值 说明
value number — 当前进度(必填),越界会被钳制
max number 100 最大值,最小按 1 处理
className string — 追加在组件类名之后

无障碍

Progress 是纯视觉元素,未附带语义角色。如果进度对任务完成至关重要,请在旁边配合文本说明当前百分比或阶段名称。

最后更新: