Progress 进度条
用于显示某个操作进度的状态。
获取组件
import { Progress } from 'rsuite';演示
默认
默认的 Progress 组件显示一个水平进度条。
状态
使用 status 属性来指示不同的状态:'active'、'success' 或 'fail'。
不确定状态
使用 indeterminate 属性显示一个动画加载状态,当进度百分比未知时使用。这会创建一个连续的动画效果,表示操作正在进行中。
颜色
使用 strokeColor 属性自定义进度条颜色。
尺寸
使用 strokeWidth 属性调整进度条的高度。您还可以使用 radius 属性自定义边框圆角。
百分比位置
使用 percentPlacement 属性控制百分比指示器的位置。选项包括 'start'、'end'、'insideStart'、'insideEnd' 和 'insideCenter'。
条纹效果
使用 striped 属性为进度条应用条纹效果。当与 'active' 状态结合使用时,条纹将会动画显示。
自定义信息内容
使用 renderInfo 属性自定义进度信息区域中显示的内容。这允许显示比默认百分比更复杂和更具信息性的内容。
多段进度
使用 sections 属性显示具有不同颜色的多个进度段。这对于可视化过程的不同部分或比较多个值非常有用。
垂直
使用 vertical 属性显示垂直进度条。状态、颜色和百分比位置等所有其他属性也适用于垂直进度条。
Props
<Progress>
| 属性名称 | 类型 (默认值) |
描述 | 版本 |
|---|---|---|---|
| classPrefix | string ('progress-line') |
组件 CSS 类的前缀 | |
| indeterminate | boolean | 显示不确定状态的加载动画 | |
| percent | number (0) |
进度百分比 | |
| percentPlacement | 'start' | 'end' | 'insideStart' | 'insideEnd' | 'insideCenter' ('end') |
百分比信息的显示位置 | |
| radius | number | string | 进度条的圆角半径 | |
| renderInfo | (percent: number, status?: 'success' | 'fail' | 'active') => ReactNode | 自定义信息内容的渲染函数 | |
| sections | ProgressSection[] | 具有不同颜色的多个进度段 | |
| showInfo | boolean (true) |
是否显示文字 | |
| status | 'success' | 'fail' | 'active' | 进度状态 | |
| striped | boolean | 是否显示条纹效果 | |
| strokeColor | string | 线条颜色 | |
| strokeWidth | number | 线条宽度 | |
| trailColor | string | 背景颜色 | |
| trailWidth | number | 背景宽度 | |
| vertical | boolean | 垂直显示进度条 | |
| width | number | 圆直径 |
ProgressSection
interface ProgressSection {
/** Percent of this section */
percent: number;
/** Color of this section */
color: string;
/** Label of this section */
label?: React.ReactNode;
/** Tooltip of this section */
tooltip?: React.ReactNode;
}