Progress 进度条
引入
在app.json
或index.json
中引入组件,详细介绍见快速上手
"usingComponents": {
"van-progress": "path/to/@vant/weapp/dist/progress/index"
}
代码演示
基础用法
进度条默认为蓝色,使用percentage
属性来设置当前进度
<van-progress percentage="50" />
线条粗细
通过stroke-width
可以设置进度条的粗细
<van-progress :percentage="50" stroke-width="8" />
置灰
<van-progress inactive percentage="50" />
样式定制
可以使用pivot-text
属性自定义文字,color
属性自定义进度条颜色
<van-progress
pivot-text="橙色"
color="#f2826a"
percentage="25"
/>
<van-progress
pivot-text="红色"
color="#ee0a24"
percentage="50"
/>
<van-progress
percentage="75"
pivot-text="紫色"
pivot-color="#7232dd"
color="linear-gradient(to right, #be99ff, #7232dd)"
/>
API
Props
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
inactive | 是否置灰 | boolean | false | - |
percentage | 进度百分比 | number | false | - |
stroke-width | 进度条粗细,默认单位为px | string | number | 4px | - |
show-pivot | 是否显示进度文字 | boolean | true | - |
color | 进度条颜色 | string | #1989fa | - |
text-color | 进度文字颜色 | string | #fff | - |
track-color | 轨道颜色 | string | #e5e5e5 | 1.0.0 |
pivot-text | 文字显示 | string | 百分比文字 | - |
pivot-color | 文字背景色 | string | 与进度条颜色一致 | - |
外部样式类
类名 | 说明 |
---|---|
custom-class | 根节点样式类 |