mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-03 04:30:06 +08:00
1e8d3ce40d
* try: init gradient line demo * demo(Progress): update instructions * chore: adjust default color * test: update case and snapshots * docs: update description for strokeColor * docs: update for more in written * test: correct type of Progress * pref: support percent for strokeColor * test: update snapshots * test: update case * pref: sort key for gradients * fix: lgtm problem * refactor: update output of sortGradient to string * chore: make traversal more elegant
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
---
|
||
category: Components
|
||
subtitle: 进度条
|
||
type: 反馈
|
||
title: Progress
|
||
---
|
||
|
||
展示操作的当前进度。
|
||
|
||
## 何时使用
|
||
|
||
在操作需要较长时间才能完成时，为用户显示该操作的当前进度和状态。
|
||
|
||
- 当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过2秒时；
|
||
- 当需要显示一个操作完成的百分比时。
|
||
|
||
## API
|
||
|
||
各类型共用的属性。
|
||
|
||
| 属性 | 说明 | 类型 | 默认值 |
|
||
| --- | --- | --- | --- |
|
||
| type | 类型，可选 `line` `circle` `dashboard` | string | `line` |
|
||
| format | 内容的模板函数 | function(percent, successPercent) | `percent => percent + '%'` |
|
||
| percent | 百分比 | number | 0 |
|
||
| showInfo | 是否显示进度数值或状态图标 | boolean | true |
|
||
| status | 状态，可选：`success` `exception` `active` `normal` | string | - |
|
||
| strokeLinecap | | Enum{ 'round', 'square' } | `round` |
|
||
| strokeColor | 进度条的色彩 | string | - |
|
||
| successPercent | 已完成的分段百分比 | number | 0 |
|
||
|
||
### `type="line"`
|
||
|
||
| 属性 | 说明 | 类型 | 默认值 |
|
||
| --- | --- | --- | --- |
|
||
| strokeWidth | 进度条线的宽度，单位 px | number | 10 |
|
||
| strokeColor | 进度条的色彩，传入 object 时为渐变 | string \| { from: string; to: string; direction: string } | - |
|
||
|
||
### `type="circle"`
|
||
|
||
| 属性 | 说明 | 类型 | 默认值 |
|
||
| --- | --- | --- | --- |
|
||
| width | 圆形进度条画布宽度，单位 px | number | 132 |
|
||
| strokeWidth | 圆形进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 |
|
||
|
||
### `type="dashboard"`
|
||
|
||
| 属性 | 说明 | 类型 | 默认值 |
|
||
| --- | --- | --- | --- |
|
||
| width | 仪表盘进度条画布宽度，单位 px | number | 132 |
|
||
| strokeWidth | 仪表盘进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 |
|
||
| gapDegree | 仪表盘进度条缺口角度，可取值 0 ~ 360 | number | 0 |
|
||
| gapPosition | 仪表盘进度条缺口位置 | Enum{ 'top', 'bottom', 'left', 'right' } | `top` |
|