进度条 Progress - Ant Design

何时使用

在操作需要较长时间才能完成时，为用户显示该操作的当前进度和状态。

当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过 2 秒时；
当需要显示一个操作完成的百分比时。

代码演示

30%

50%

标准的进度条。

30%

50%

小型进度条

适合放在较狭窄的区域内。

30%

小型进度圈

小一号的圈形进度。

75 Days

Done

自定义文字格式

format 属性指定格式。

60%

60%

60%

分段进度条

分段展示进度，可以用于细化进度语义。

99.9%

50%

90%

93%

90%

93%

自定义进度条渐变色

渐变色封装，circle 与 dashboard 设置渐变时 strokeLinecap 会被忽略。

Custom count:

Custom gap:

50%

步骤进度圈

步骤进度圈，支持颜色分段展示，默认间隔为 2px。

5.16.0

0%

10%

50%

60%

100%

60%

60%

改变进度数值位置

改变进度数值位置，可使用 percentPosition 调整，使进度条数值在进度条内部、外部或底部。

5.18.0

75%

圈形的进度。

代码发布

响应式进度圈

响应式的圈形进度，当 width 小于等于 20 的时候，进度信息将不会显示在进度圈里面，而是以 Tooltip 的形式显示。

0%

0%

会动的进度条才是好进度条。

75%

75%

通过设置 type=dashboard，可以很方便地实现仪表盘样式的进度条。若想要修改缺口的角度，可以设置 gapDegree 为你想要的值。

75%

75%

75%

通过设定 strokeLinecap="butt" 可以将进度条边缘的形状从闭合的圆形的圆弧调整为断口，详见 stroke-linecap。

50%

30%

60%

步骤进度条

带步骤的进度条。

50%

50%

50%

50%

50%

50%

50%

50%

50%

50%

50%

进度条尺寸。

API

通用属性参考：通用属性

各类型共用的属性。

属性	说明	类型	默认值	版本
format	内容的模板函数	function(percent, successPercent)	(percent) => percent + `%`	-
percent	百分比	number	0	-
showInfo	是否显示进度数值或状态图标	boolean	true	-
status	状态，可选：`success` `exception` `normal` `active`(仅限 line)	string	-	-
strokeColor	进度条的色彩	string	-	-
strokeLinecap	进度条的样式	`round` \| `butt` \| `square`，区别详见 stroke-linecap	`round`	-
success	成功进度条相关配置	{ percent: number, strokeColor: string }	-	-
trailColor	未完成的分段的颜色	string	-	-
type	类型，可选 `line` `circle` `dashboard`	string	`line`	-
size	进度条的尺寸	number \| [number \| string, number] \| { width: number, height: number } \| "small" \| "default"	"default"	5.3.0, Object: 5.18.0

`type="line"`

属性	说明	类型	默认值	版本
steps	进度条总共步数	number	-	-
rounding	用于四舍五入数值的函数	(step: number) => number	Math.round	5.24.0
strokeColor	进度条的色彩，传入 object 时为渐变。当有 `steps` 时支持传入一个数组。	string \| string[] \| { from: string; to: string; direction: string }	-	4.21.0: `string[]`
percentPosition	进度数值位置，传入对象，`align` 表示数值的水平位置，`type` 表示数值在进度条内部还是外部	{ align: string; type: string }	{ align: "end", type: "outer" }	5.18.0

`type="circle"`

属性	说明	类型	默认值	版本
steps	进度条总共步数，传入 object 时，count 指步数，gap 指间隔大小。传 number 类型时，gap 默认为 2。	number \| { count: number, gap: number }	-	5.16.0
strokeColor	圆形进度条线的色彩，传入 object 时为渐变	string \| { number%: string }	-	-
strokeWidth	圆形进度条线的宽度，单位是进度条画布宽度的百分比	number	6	-

`type="dashboard"`

属性	说明	类型	默认值	版本
steps	进度条总共步数，传入 object 时，count 指步数，gap 指间隔大小。传 number 类型时，gap 默认为 2。	number \| { count: number, gap: number }	-	5.16.0
gapDegree	仪表盘进度条缺口角度，可取值 0 ~ 295	number	75	-
gapPosition	仪表盘进度条缺口位置	`top` \| `bottom` \| `left` \| `right`	`bottom`	-
strokeWidth	仪表盘进度条线的宽度，单位是进度条画布宽度的百分比	number	6	-

主题变量（Design Token）

组件 Token如何定制？

Token 名称	描述	类型	默认值
circleIconFontSize	圆形进度条图标大小	string	1.1666666666666667em
circleTextColor	圆形进度条文字颜色	string	rgba(0,0,0,0.88)
circleTextFontSize	圆形进度条文本大小	string	1em
defaultColor	进度条默认颜色	string	#1677ff
lineBorderRadius	条状进度条圆角	number	100
remainingColor	进度条剩余部分颜色	string	rgba(0,0,0,0.06)

全局 Token如何定制？