2016-03-31 14:17:09 +08:00
|
|
|
---
|
|
|
|
|
category: Components
|
2016-09-21 11:28:38 +08:00
|
|
|
subtitle: 进度条
|
2018-11-04 16:20:35 +08:00
|
|
|
type: 反馈
|
2016-09-21 11:28:38 +08:00
|
|
|
title: Progress
|
2020-06-05 13:50:09 +08:00
|
|
|
cover: https://gw.alipayobjects.com/zos/alicdn/xqsDu4ZyR/Progress.svg
|
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
|
|
|
|
2019-05-07 14:57:32 +08:00
|
|
|
- 当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过 2 秒时；
|
2016-07-26 15:42:04 +08:00
|
|
|
- 当需要显示一个操作完成的百分比时。
|
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
|
|
|
|
2019-01-29 15:23:23 +08:00
|
|
|
各类型共用的属性。
|
|
|
|
|
|
2019-11-20 17:46:50 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 |
|
|
|
|
|
| --- | --- | --- | --- |
|
2020-07-02 15:33:42 +08:00
|
|
|
| format | 内容的模板函数 | function(percent, successPercent) | (percent) => percent + `%` |
|
2019-11-20 17:46:50 +08:00
|
|
|
| percent | 百分比 | number | 0 |
|
|
|
|
|
| showInfo | 是否显示进度数值或状态图标 | boolean | true |
|
|
|
|
|
| status | 状态，可选：`success` `exception` `normal` `active`(仅限 line) | string | - |
|
|
|
|
|
| strokeColor | 进度条的色彩 | string | - |
|
2022-05-08 23:57:17 +08:00
|
|
|
| strokeLinecap | 进度条的样式 | `round` \| `butt` \| `square`，区别详见 [stroke-linecap](https://developer.mozilla.org/docs/Web/SVG/Attribute/stroke-linecap) | `round` |
|
2020-07-01 23:32:22 +08:00
|
|
|
| success | 成功进度条相关配置 | { percent: number, strokeColor: string } | - |
|
2020-10-21 10:33:43 +08:00
|
|
|
| trailColor | 未完成的分段的颜色 | string | - |
|
|
|
|
|
| type | 类型，可选 `line` `circle` `dashboard` | string | `line` |
|
2019-01-29 15:23:23 +08:00
|
|
|
|
|
|
|
|
### `type="line"`
|
|
|
|
|
|
2022-06-01 23:00:03 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| steps | 进度条总共步数 | number | - | - |
|
|
|
|
|
| strokeColor | 进度条的色彩，传入 object 时为渐变。当有 `steps` 时支持传入一个数组。 | string \| string[] \| { from: string; to: string; direction: string } | - | 4.21.0: `string[]` |
|
|
|
|
|
| strokeWidth | 进度条线的宽度，单位 px | number | 10 | - |
|
2019-01-29 15:23:23 +08:00
|
|
|
|
|
|
|
|
### `type="circle"`
|
|
|
|
|
|
2022-04-11 17:41:54 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 |
|
|
|
|
|
| ----------- | ------------------------------------------------ | ---------------- | ------ |
|
|
|
|
|
| strokeColor | 圆形进度条线的色彩，传入 object 时为渐变 | string \| object | - |
|
|
|
|
|
| strokeWidth | 圆形进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 |
|
|
|
|
|
| width | 圆形进度条画布宽度，单位 px | number | 132 |
|
2019-01-29 15:23:23 +08:00
|
|
|
|
|
|
|
|
### `type="dashboard"`
|
|
|
|
|
|
2019-11-20 17:46:50 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 |
|
|
|
|
|
| --- | --- | --- | --- |
|
2020-03-22 17:59:43 +08:00
|
|
|
| gapDegree | 仪表盘进度条缺口角度，可取值 0 ~ 295 | number | 75 |
|
|
|
|
|
| gapPosition | 仪表盘进度条缺口位置 | `top` \| `bottom` \| `left` \| `right` | `bottom` |
|
2020-10-21 10:33:43 +08:00
|
|
|
| strokeWidth | 仪表盘进度条线的宽度，单位是进度条画布宽度的百分比 | number | 6 |
|
|
|
|
|
| width | 仪表盘进度条画布宽度，单位 px | number | 132 |
|
