Display the current progress of an operation flow.
If it will take a long time to complete an operation, you can use Progress to show the current progress and status.
Common props ref：Common props
Properties that shared by all types.
| Property | Description | Type | Default | Version |
|---|---|---|---|---|
| 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 | |
| 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 | 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 | |
| size | Progress size | number | [number | string, number] | "small" | "default" | "default" | v5.3.0 |
type="line"| Property | Description | Type | Default | Version |
|---|---|---|---|---|
| steps | The total step count | number | - | - |
| strokeColor | The color of progress bar, render linear-gradient when passing an object, could accept string[] when has steps. | string | string[] | { from: string; to: string; direction: string } | - | 4.21.0: string[] |
type="circle"| Property | Description | Type | Default | Version |
|---|---|---|---|---|
| strokeColor | The color of circular progress, render gradient when passing an object | string | { number%: string } | - | - |
| strokeWidth | To set the width of the circular progress, unit: percentage of the canvas width | number | 6 | - |
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 |
| Token Name | Description | Type | Default Value |
|---|---|---|---|
| circleTextColor | Text color of circular progress bar | string | rgba(0, 0, 0, 0.88) |
| circleTextFontSize | Text size of circular progress bar | string | 1em |
| defaultColor | Default color of progress bar | string | #1677ff |
| lineBorderRadius | Border radius of line progress bar | number | 100 |
| remainingColor | Color of remaining part of progress bar | string | rgba(0, 0, 0, 0.06) |
A standard progress bar.
Appropriate for a narrow area.
A smaller circular progress bar.
You can set a custom text by setting the format prop.
Show several parts of progress with different status.
Gradient encapsulation, circle and dashboard will ignore strokeLinecap when setting gradient.
The size of progress.
A circular progress bar.
Responsive circular progress bar. When width is smaller than 20, progress information will be displayed in Tooltip.
A dynamic progress bar is better.
By setting type=dashboard, you can get a dashboard style of progress easily. Modify gapDegree to set the degree of gap.
By setting strokeLinecap="butt", you can change the linecaps from round to butt, see stroke-linecap for more information.
A progress bar with steps.
