# Progress

- category: Components
- chinese: 进度条
- type: 展示

---

展示操作的当前进度。

## 何时使用

在操作需要较长时间才能完成时，为用户显示该操作的当前进度和状态。

* 当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过2秒时；
* 当需要显示一个操作完成的百分比时。


## Progress Circle API

| 参数     | 说明           | 类型     | 默认值       |
|----------|---------------|----------|-------------|
| percent  | 百分比         | number   | 0           |
| status   | 状态，有两个值normal、exception | string   | normal |
| strokeWidth | 进度条线的宽度，单位是进度条画布宽度的百分比 | number | 1           |
| width | 必填，进度条画布宽度，单位px。这里没有提供height属性设置，Line型高度就是strokeWidth，Circle型高度等于width | number | null |


## Progress Bar API

| 参数     | 说明           | 类型     | 默认值       |
|----------|---------------|----------|-------------|
| percent  | 百分比         | number   | 0           |
| status   | 状态，有两个值normal、exception、active三种状态 | string   | normal |
| strokeWidth | 进度条线的宽度，单位是px | number | 1           |
| showInfo | 是否显示进度数值和状态图标 | bool | true           |