2023-07-28 10:45:13 +08:00

93 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<frame/>
# Progress 进度条
## 基本用法
设置百分比 `percentage`
```html
<wd-progress percentage="30" />
```
## 隐藏进度文字
设置 `hide-text` 隐藏进度文字。
```html
<wd-progress percentage="60" hide-text>
```
## 设置状态
设置 `status`,告知用户当前状态和预期。
```html
<wd-progress percentage="100" hide-text status="success" />
<wd-progress percentage="70" hide-text status="danger" />
```
## 修改颜色
设置 `color` 修改进度条颜色。
```html
<wd-progress percentage="80" color="#00c740">
```
`color` 也可以设置为数组或者函数。数组如果只传入颜色,则自动计算每个颜色的进度边界。函数需要返回一个颜色值。
```html
<wd-progress percentage="100" color="{{[ '#00c740', '#ffb300', '#e2231a', '#0083ff' ]}}" />
```
数组也可以设置为以下格式:
```html
<wd-progress percentage="{{percentage}}" color="{{colorObject}}"/>
```
```javascript
Page({
data: {
colorObject: [
{
color: 'yellow',
percentage: 30
},
{
color: 'red',
percentage: 60
},
{
color: 'blue',
percentage: 80
},
{
color: 'black',
percentage: 90
}
],
percentage: 100
}
})
```
## Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 | 最低版本 |
|-----|-----|------|-------|-------|--------|
| percentage | 进度数值最大值100 | number | - | 0 | - |
| hide-text | 隐藏进度文字 | boolean | - | false | - |
| color | 进度条颜色 | string / array | - | linear-gradient(315deg, rgba(81,124,240,1) 0%,rgba(118,158,245,1) 100%) | - |
| status | 进度条状态 | string | success / danger | - | - |
| duration | 进度增加1%所需毫秒数 | number | - | 30 | - |
## 外部样式类
| 类名 | 说明 | 最低版本 |
|-----|------|--------|
| custom-class | 根结点样式 | - |