更新记录
0.0.3(2023-06-06)
优化文档
0.0.2(2023-06-04)
将公共依赖提取至hd-utils
0.0.1(2023-06-02)
基于Vue3和TypeScript开发的uni-app 圆环形的进度条组件,支持进度渐变动画。
查看更多平台兼容性
Vue2 | Vue3 |
---|---|
× | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.7.11 app-vue | × | √ | √ | × | × | √ |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
√ | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | × | × | × | × | × |
组件库官方文档:fant-mini-plus
组件库提供更多vue3组件,比单独引入更加强大
Circle 环形进度条
圆环形的进度条组件,支持进度渐变动画。
代码演示
基础用法
通过v-model
表示进度条的当前进度,text
属性控制进度条中间文字内容。
<hd-circle v-model="current" :text="`进度:${current}%`"></hd-circle>
const current = ref<number>(10)
宽度控制
通过strokeWidth
属性来控制进度条宽度,默认20rpx
。
<hd-circle v-model="current" :strokeWidth="15"></hd-circle>
颜色定制
通过color
属性控制进度条颜色,默认#1C64FD
,通过layerColor
属性控制进度条轨道颜色,默认#EBEEF5
。
<hd-circle v-model="current" color="#1C64FD" layerColor="#EBEEF5"></hd-circle>
渐变色
color
属性支持传入对象格式来定义渐变色。
<hd-circle v-model="current" :color="gradientColor"></hd-circle>
const gradientColor = {
'0%': '#ffd01e',
'100%': '#ee0a24'
}
进度条展开方向
通过clockwise
属性控制进度条展开方向,clockwise
为false
时,进度会从逆时针方向开始。
<hd-circle v-model="current" :clockwise="false"></hd-circle>
大小定制
通过size
属性控制进度条圆环直径,默认200rpx
。
<hd-circle v-model="current" :size="300"></hd-circle>
Props
Name | Description | Type | Required | Default | ||
---|---|---|---|---|---|---|
value | 当前进度 | Number |
false |
0 | ||
rate | 目标进度 | Number / String |
false |
100 | ||
size | 圆环直径,默认单位为 rpx | String / Number |
false |
200 | ||
color | 进度条颜色,传入对象格式可以定义渐变色 | String / Object |
false |
#1C64FD | ||
layerColor | 轨道颜色 | String |
false |
#EBEEF5 | ||
fill | 填充颜色 | String |
false |
#ffffff | ||
speed | 动画速度(单位为 rate/s) | Number |
false |
50 | ||
text | 文字 | String |
false |
- | ||
strokeWidth | 进度条宽度 单位rpx | Number |
false |
20 | ||
strokeLinecap | 进度条端点的形状,可选值为 "butt" | "round" | "square" | 'butt' / 'round' / 'square' |
false |
round |
clockwise | 是否顺时针增加 | Boolean |
false |
false |
Slots
Name | Description | Default Slot Content |
---|---|---|
default | 自定义提示内容 | - |
联系方式
有不明白或者建议可以扫码交流