mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-15 17:31:25 +08:00
6ca32a6665
* refactor: Progress type="circle" for some issues close #17706 close #35009 close #35352 * test: update progress snapshot * docs: update linecap.md * Update components/progress/demo/linecap.md * test: update progress snapshot * fix: rc-progress@~3.3.1 * fix: rc-progress@~3.3.2
58 lines
2.8 KiB
Markdown
58 lines
2.8 KiB
Markdown
---
|
|
category: Components
|
|
type: Feedback
|
|
title: Progress
|
|
cover: https://gw.alipayobjects.com/zos/alicdn/xqsDu4ZyR/Progress.svg
|
|
---
|
|
|
|
Display the current progress of an operation flow.
|
|
|
|
## When To Use
|
|
|
|
If it will take a long time to complete an operation, you can use `Progress` to show the current progress and status.
|
|
|
|
- When an operation will interrupt the current interface, or it needs to run in the background for more than 2 seconds.
|
|
- When you need to display the completion percentage of an operation.
|
|
|
|
## API
|
|
|
|
Properties that shared by all types.
|
|
|
|
| Property | Description | Type | Default |
|
|
| --- | --- | --- | --- |
|
|
| format | The template function of the content | function(percent, successPercent) | (percent) => percent + `%` |
|
|
| percent | To set the completion percentage | number | 0 |
|
|
| showInfo | Whether to display the progress value and the status icon | boolean | true |
|
|
| size | To set the size of the progress | `default` \| `small` | `default` |
|
|
| status | To set the status of the progress, options: `success` `exception` `normal` `active`(line only) | string | - |
|
|
| strokeColor | The color of progress bar | string | - |
|
|
| strokeLinecap | To set the style of the progress linecap | `round` \| `butt` \| `square`, see [stroke-linecap](https://developer.mozilla.org/docs/Web/SVG/Attribute/stroke-linecap) | `round` |
|
|
| success | Configs of successfully progress bar | { percent: number, strokeColor: string } | - |
|
|
| trailColor | The color of unfilled part | string | - |
|
|
| type | To set the type, options: `line` `circle` `dashboard` | string | `line` |
|
|
|
|
### `type="line"`
|
|
|
|
| Property | Description | Type | Default |
|
|
| --- | --- | --- | --- |
|
|
| steps | The total step count | number | - |
|
|
| strokeColor | The color of progress bar, render `linear-gradient` when passing an object | string \| { from: string; to: string; direction: string } | - |
|
|
| strokeWidth | To set the width of the progress bar, unit: `px` | number | 10 |
|
|
|
|
### `type="circle"`
|
|
|
|
| Property | Description | Type | Default |
|
|
| --- | --- | --- | --- |
|
|
| strokeColor | The color of circular progress, render `linear-gradient` when passing an object | string \| object | - |
|
|
| strokeWidth | To set the width of the circular progress, unit: percentage of the canvas width | number | 6 |
|
|
| width | To set the canvas width of the circular progress, unit: `px` | number | 132 |
|
|
|
|
### `type="dashboard"`
|
|
|
|
| Property | Description | Type | Default |
|
|
| --- | --- | --- | --- |
|
|
| gapDegree | The gap degree of half circle, 0 ~ 295 | number | 75 |
|
|
| gapPosition | The gap position, options: `top` `bottom` `left` `right` | string | `bottom` |
|
|
| strokeWidth | To set the width of the dashboard progress, unit: percentage of the canvas width | number | 6 |
|
|
| width | To set the canvas width of the dashboard progress, unit: `px` | number | 132 |
|