ant-design/components/progress/index.en-US.md
afc163 6ca32a6665
refactor: Progress type="circle" for some issues (#35433)
* 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
2022-05-08 23:57:17 +08:00

2.8 KiB

category type title cover
Components Feedback Progress 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 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