2018-10-09 14:28:02 +08:00

76 lines
1.5 KiB
Markdown

## Progress 进度条
### 使用指南
在 index.json 中引入组件
```json
"usingComponents": {
"van-progress": "path/to/vant-weapp/dist/progress/index"
}
```
### 代码演示
#### 基础用法
进度条默认为蓝色,使用`percentage`属性来设置当前进度
```html
<van-progress percentage="50" />
```
#### 置灰
```html
<van-progress inactive percentage="50" />
```
#### 样式定制
可以使用`pivot-text`属性自定义文字,`color`属性自定义进度条颜色
```html
<van-progress
pivot-text="橙色"
color="#f2826a"
percentage="25"
/>
<van-progress
pivot-text="红色"
color="#f44"
percentage="50"
/>
<van-progress
percentage="75"
pivot-text="紫色"
pivot-color="#7232dd"
color="linear-gradient(to right, #be99ff, #7232dd)"
/>
```
### API
| 参数 | 说明 | 类型 | 默认值 |
|-----------|-----------|-----------|-------------|
| inactive | 是否置灰 | `Boolean` | `false` |
| percentage | 进度百分比 | `Number` | `false` |
| show-pivot | 是否显示进度文字 | `Boolean` | `true` |
| color | 进度条颜色 | `String` | `#38f` |
| text-color | 进度条文字颜色 | `String` | `#fff` |
| pivot-text | 文字显示 | `String` | 百分比文字 |
| pivot-color | 文字背景色 | `String` | 与进度条颜色一致 |
### 外部样式类
| 类名 | 说明 |
|-----------|-----------|
| custom-class | 根节点样式类 |
### 更新日志
| 版本 | 类型 | 内容 |
|-----------|-----------|-----------|
| 0.2.1 | feature | 新增组件 |