Progress进度条
Progress
进度条
展示操作的当前进度。
使用import{ Progress }from"antd"; |
开发
设计
何时使用
在操作需要较长时间才能完成时，为用户显示该操作的当前进度和状态。
- 当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过 2 秒时；
- 当需要显示一个操作完成的百分比时。
代码演示
30%
50%
标准的进度条。
30%
50%
适合放在较狭窄的区域内。
30%
小一号的圈形进度。
75 Days
Done
format 属性指定格式。
60%
60%
60%
分段展示进度，可以用于细化进度语义。
99.9%
50%
90%
93%
90%
93%
渐变色封装，circle 与 dashboard 设置渐变时 strokeLinecap 会被忽略。
Custom count:
Custom gap:
50%
步骤进度圈，支持颜色分段展示，默认间隔为 2px。
5.16.0
0%
10%
50%
60%
100%
60%
60%
改变进度数值位置，可使用 percentPosition 调整，使进度条数值在进度条内部、外部或底部。
5.18.0
75%
圈形的进度。
代码发布
响应式的圈形进度，当 width 小于等于 20 的时候，进度信息将不会显示在进度圈里面，而是以 Tooltip 的形式显示。
0%
0%
会动的进度条才是好进度条。
75%
75%
通过设置 type=dashboard，可以很方便地实现仪表盘样式的进度条。若想要修改缺口的角度，可以设置 gapDegree 为你想要的值。
75%
75%
75%
通过设定 strokeLinecap="butt" 可以将进度条边缘的形状从闭合的圆形的圆弧调整为断口，详见 stroke-linecap。
50%
30%
60%
带步骤的进度条。
50%
50%
50%
50%
50%
50%
50%
50%
50%
50%
50%
进度条尺寸。
API
通用属性参考：通用属性
各类型共用的属性。
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| format | 内容的模板函数 | function(percent, successPercent) | (percent) => percent + % | - |
| percent | 百分比 | number | 0 | - |
| showInfo | 是否显示进度数值或状态图标 | boolean | true | - |
| status | 状态，可选：success exception normal active(仅限 line) | string | - | - |
| strokeColor | 进度条的色彩 | string | - | - |
| strokeLinecap | 进度条的样式 | round | butt | square，区别详见 stroke-linecap | round | - |
| success | 成功进度条相关配置 | { percent: number, strokeColor: string } | - | - |
| trailColor | 未完成的分段的颜色 | string | - | - |
| type | 类型，可选 line circle dashboard | string | line | - |
| size | 进度条的尺寸 | number | [number | string, number] | { width: number, height: number } | "small" | "default" | "default" | 5.3.0, Object: 5.18.0 |
type="line"
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| steps | 进度条总共步数 | number | - | - |
| rounding | 用于四舍五入数值的函数 | (step: number) => number | Math.round | 5.24.0 |
| strokeColor | 进度条的色彩，传入 object 时为渐变。当有 steps 时支持传入一个数组。 | string | string[] | { from: string; to: string; direction: string } | - | 4.21.0: string[] |
| percentPosition | 进度数值位置，传入对象，align 表示数值的水平位置，type 表示数值在进度条内部还是外部 | { align: string; type: string } | { align: "end", type: "outer" } | 5.18.0 |
type="circle"
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| steps | 进度条总共步数，传入 object 时，count 指步数，gap 指间隔大小。传 number 类型时，gap 默认为 2。 | number | { count: number, gap: number } | - | 5.16.0 |
| strokeColor | 圆形进度条线的色彩，传入 object 时为渐变 | string | { number%: string } | - | - |
| strokeWidth | 圆形进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 | - |
type="dashboard"
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| steps | 进度条总共步数，传入 object 时，count 指步数，gap 指间隔大小。传 number 类型时，gap 默认为 2。 | number | { count: number, gap: number } | - | 5.16.0 |
| gapDegree | 仪表盘进度条缺口角度，可取值 0 ~ 295 | number | 75 | - |
| gapPosition | 仪表盘进度条缺口位置 | top | bottom | left | right | bottom | - |
| strokeWidth | 仪表盘进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 | - |
主题变量（Design Token）
组件 Token如何定制？
| Token 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| circleIconFontSize | 圆形进度条图标大小 | string | 1.1666666666666667em |
| circleTextColor | 圆形进度条文字颜色 | string | rgba(0,0,0,0.88) |
| circleTextFontSize | 圆形进度条文本大小 | string | 1em |
| defaultColor | 进度条默认颜色 | string | #1677ff |
| lineBorderRadius | 条状进度条圆角 | number | 100 |
| remainingColor | 进度条剩余部分颜色 | string | rgba(0,0,0,0.06) |