2016-03-31 14:17:09 +08:00
|
|
|
|
---
|
|
|
|
|
|
category: Components
|
2016-09-21 11:28:38 +08:00
|
|
|
|
subtitle: 进度条
|
2016-11-09 14:43:32 +08:00
|
|
|
|
type: Feedback
|
2016-09-21 11:28:38 +08:00
|
|
|
|
title: Progress
|
2016-03-31 14:17:09 +08:00
|
|
|
|
---
|
2015-05-27 15:43:29 +08:00
|
|
|
|
|
2015-06-15 14:43:27 +08:00
|
|
|
|
展示操作的当前进度。
|
2015-05-27 15:43:29 +08:00
|
|
|
|
|
2015-06-15 14:43:27 +08:00
|
|
|
|
## 何时使用
|
2015-05-27 15:43:29 +08:00
|
|
|
|
|
2015-06-19 10:42:49 +08:00
|
|
|
|
在操作需要较长时间才能完成时，为用户显示该操作的当前进度和状态。
|
2015-06-18 11:25:38 +08:00
|
|
|
|
|
2016-07-26 15:42:04 +08:00
|
|
|
|
- 当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过2秒时；
|
|
|
|
|
|
- 当需要显示一个操作完成的百分比时。
|
2015-06-18 11:25:38 +08:00
|
|
|
|
|
2016-04-05 16:55:52 +08:00
|
|
|
|
## API
|
2015-07-29 23:36:27 +08:00
|
|
|
|
|
2017-10-25 10:25:44 +08:00
|
|
|
|
| 属性 | 说明 | 类型 | 默认值 |
|
|
|
|
|
|
| --- | --- | --- | --- |
|
2018-04-22 14:00:49 +08:00
|
|
|
|
| format | 内容的模板函数 | function(percent, successPercent) | `percent => percent + '%'` |
|
2017-10-25 10:25:44 +08:00
|
|
|
|
| gapDegree `(type=circle)` | 圆形进度条缺口角度，可取值 0 ~ 360 | number | 0 |
|
|
|
|
|
|
| gapPosition `(type=circle)` | 圆形进度条缺口位置 | Enum{ 'top', 'bottom', 'left', 'right' } | `top` |
|
|
|
|
|
|
| percent | 百分比 | number | 0 |
|
|
|
|
|
|
| showInfo | 是否显示进度数值或状态图标 | boolean | true |
|
|
|
|
|
|
| status | 状态，可选：`success` `exception` `active` | string | - |
|
2017-01-20 20:10:50 +08:00
|
|
|
|
| strokeWidth `(type=line)` | 进度条线的宽度，单位 px | number | 10 |
|
|
|
|
|
|
| strokeWidth `(type=circle)` | 圆形进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 |
|
2017-10-25 10:25:44 +08:00
|
|
|
|
| type | 类型，可选 `line` `circle` `dashboard` | string | line |
|
2017-01-20 20:10:50 +08:00
|
|
|
|
| width `(type=circle)` | 圆形进度条画布宽度，单位 px | number | 132 |
|
2018-01-19 15:22:37 +08:00
|
|
|
|
| successPercent | 已完成的分段百分比，`type="line"` 时有效 | number | 0 |
|
