使用场景:在操作需要较长时间才能完成时,为用户显示该操作的当前进度和状态;操作在后台运行,需要耗费一定的客户端等待时间;操作需要展示一个完成进度的百分比。
普通模式的进度条,通过 textRender 来自定义进度条提示信息,当返回 false 时,不显示进度条提示内容。可以通过 size 属性制定进度条的大小。 Progress 有三种状态,分别是常规状态、成功状态,和失败状态。您可以通过 state 属性展示流程的不同周期。或者不提供 state 属性值, shape 设置进度条的样式。
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
size | 尺寸 可选值: 'small', 'medium', 'large' | Enum | 'medium' |
shape | 形态 可选值: 'circle', 'line' | Enum | 'line' |
percent | 所占百分比 | Number | 0 |
state | 进度状态, 显示优先级: color > progressive > state 可选值: 'normal', 'success', 'error' | Enum | 'normal' |
progressive | 是否为色彩阶段变化模式, 显示优先级: color > progressive > state | Boolean | false |
hasBorder | 是否添加 Border(只适用于 Line Progress) | Boolean | false |
textRender | 文本渲染函数 签名: Function(percent: Number, option: Object) => ReactNode 参数: percent: {Number} 当前的进度信息 option: {Object} 额外的参数 返回值: {ReactNode} 返回文本节点 | Function | percent => ${Math.floor(percent)}% |
color | 进度条颜色, 显示优先级: color > progressive > state | String | - |
backgroundColor | 背景色 | String | - |