Skip to content

进度条组件

进度条组件

进度条组件用于展示操作的当前进度,让用户了解当前任务的完成情况。

基础用法

基础进度条用于展示百分比进度。

显示代码箭头
复制GitHub

进度条状态

进度条提供了四种状态:默认、成功、警告和异常。

默认
成功
警告
异常
显示代码箭头
复制GitHub

文本内显

设置 textInside 属性可以将百分比显示在进度条内部。

显示代码箭头
复制GitHub

自定义颜色

通过 color 属性可以自定义进度条颜色,支持单色、多色区间和动态函数三种方式。

自定义单色
自定义单色
分段颜色
函数计算颜色
显示代码箭头
复制GitHub

环形进度条

设置 typecircle 可以使用环形进度条。

显示代码箭头
复制GitHub

仪表盘形进度条

设置 typedashboard 可以使用仪表盘形进度条。

25%
75%
完成
0%
显示代码箭头
复制GitHub

条纹效果

设置 striped 属性可以让进度条呈现条纹效果,设置 stripedFlow 可以让条纹动起来。

静态条纹
动态条纹
成功状态动态条纹
警告状态动态条纹
异常状态动态条纹
显示代码箭头
复制GitHub

自定义尺寸

设置 strokeWidth 属性可以改变进度条的粗细,对于环形和仪表盘进度条,还可以通过 width 属性设置整体尺寸。

线性进度条粗细

默认高度 6px
高度 12px
高度 18px
高度 24px

环形进度条尺寸

80px
100px
120px

环形进度条粗细

strokeWidth: 3px
strokeWidth: 6px (默认)
strokeWidth: 10px
显示代码箭头
复制GitHub

不确定进度

设置 indeterminate 属性可以创建不确定进度效果,适用于无法准确获知进度的场景。

默认不确定进度
快速动画 (duration=2)
缓慢动画 (duration=5)
自定义颜色
粗线条
显示代码箭头
复制GitHub

自定义文本格式

通过 format 属性可以自定义显示文本格式,也可以使用默认插槽完全自定义内容。

使用format属性

使用默认插槽

显示代码箭头
复制GitHub

进度条 API

属性

属性名说明类型可选值默认值
percentage百分比值number0-1000
type进度条类型stringline / circle / dashboardline
strokeWidth进度条宽度number6
textInside是否在进度条内显示文字booleanfalse
status进度条状态stringsuccess / warning / exception
indeterminate是否为不确定进度条booleanfalse
duration动画持续时间number3
color进度条颜色string / function / array
width环形/仪表盘进度条宽度number126
showText是否显示进度文字booleantrue
strokeLinecap进度条端点形状stringbutt / round / squareround
format自定义文本格式function(percentage)
striped是否有条纹booleanfalse
stripedFlow条纹是否流动booleanfalse

插槽

插槽名说明作用域参数
default自定义进度条文本内容

样式变量

进度条组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$theme-color-primary主题色-主要
$theme-color-success主题色-成功
$theme-color-warning主题色-警告
$theme-color-danger主题色-危险
$color-white白色
$text-color-default默认文本颜色
$bg-color-default默认背景颜色

基于MIT许可发布