Progress 进度条

此组件展示操作或任务的当前进度,比如上传文件,是一个线形的进度条。
平台差异说明
| APP | H5 | 微信小程序 | 支付宝小程序 | QQ小程序 | ··· |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | 适配中 |
代码示例
部分功能示例,具体可参考示例程序以及文档API。
基础用法
- 通过
mode属性设置进度条的类型(默认 line),可选值为line和circle。 - 通过
percent属性设置当前的进度值,此值区间为 0-100。 - 通过
activeColor属性设置进度条的颜色。
html
<!-- 线性 Progress -->
<fu-progress :percent="50"></fu-progress>
<!-- 圆形 Progress -->
<fu-progress :percent="25" mode="circle"></fu-progress>设置不显示百分比
通过 showPercent 属性设置是否显示进度条内百分值
html
<fu-progress :percent="50" :showPercent="false"></fu-progress>自定义高度及大小
- 通过
height属性设置进度条的高度(仅mode="line"时有效) - 通过
size属性设置进度条的大小(仅mode="circle"时有效)
html
<!-- 线性 Progress -->
<fu-progress :percent="50" height="20"></fu-progress>
<!-- 圆形 Progress -->
<fu-progress :percent="50" size="200"></fu-progress>自定义样式(不支持安卓环境的nvue)
数值自定义样式,需要将数值嵌套在默认插槽内
html
<fu-progress :percent="percentage1">
<text class="fu-percent-slot">{{ `${percentage1}%` }}</text>
</fu-progress>
<style lang="scss" scoped>
.fu-percent-slot {
padding: 1px 5px;
background-color: #01BEFF;
color: #ffffff;
border-radius: 100px;
font-size: 10px;
margin-right: -5px;
}
</style>API
Progress Props
| 属性名 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| mode | 进度条类型 | String | line | circle |
| activeColor | 进度条激活部分的颜色 | String | #2979ff | - |
| inactiveColor | 进度条的底色 | String | #f0f0f0 | - |
| percent | 进度百分比,数值 | String|Number | 0 | - |
| showPercent | 是否在进度内部显示百分比的值 | Boolean | true | false |
| height | 进度条的高度(仅 mode="line" 时有效) | Number | 12 | - |
| size | 进度条的大小(仅 mode="circle" 时有效) | Number | 200 | - |
| borderWidth | 进度条圆环宽度(仅 mode="circle" 时有效) | String|Number | 14 | - |
| duration | 圆环执行动画的时间,单位 ms(仅mode = circle有效) | Number | 1500 | - |
Progress Slot
| 名称 | 说明 |
|---|---|
| default | 传入自定义显示的内容,将会覆盖默认显示的百分比值 |