# 介绍
圆环形的进度条组件,支持进度渐变动画。
# 引入
在app.json或index.json中引入组件,详细介绍见快速上手
"usingComponents": {
"mx-circle": "/miniprogram_npm/m-ui/mx-circle/index",
}
# 小程序码
可使用微信扫码查看小程序码
#
# 代码演示
# 基本用法
value属性表示进度条的目标进度。
<mx-circle value="{{ 30 }}" text="text" />
# 宽度定制
通过stroke-width属性来控制进度条宽度。
<mx-circle value="{{ value }}" stroke-width="6" text="宽度定制" />
# 颜色定制
通过color属性来控制进度条颜色,layer-color属性来控制轨道颜色。
<mx-circle
value="{{ value }}"
layer-color="#eeeeee"
color="#ee0a24"
text="颜色定制"
/>
# 渐变色
color属性支持传入对象格式来定义渐变色。
<mx-circle value="{{ value }}" color="{{ gradientColor }}" text="渐变色" />
Page({
data: {
value: 25,
gradientColor: {
'0%': '#ffd01e',
'100%': '#ee0a24',
},
},
});
# 逆时针方向
将clockwise设置为false,进度会从逆时针方向开始。
<mx-circle
value="{{ value }}"
color="#07c160"
clockwise="{{ false }}"
text="逆时针"
/>
# 大小定制
通过size属性设置圆环直径
<mx-circle value="{{ value }}" size="90" text="大小定制" />
# API
# Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
value | 目标进度 | number | 0 |
type | 指定 canvas 类型,可选值为 2d | string | - |
size | 圆环直径,默认单位为 px | number | 64 |
color | 进度条颜色,传入对象格式可以定义渐变色 | string,object | #267AFF |
layer-color | 轨道颜色 | string | #EEEEEE |
fill | 填充颜色 | string | - |
speed | 动画速度(单位为 value/s) | number | 50 |
text | 文字 | string | - |
text-size | 文本字体大小 | string | 14 |
stroke-width | 进度条宽度 | number | 6 |
clockwise | 是否顺时针增加 | boolean | true |
# Slot
名称 | 说明 |
---|---|
- | 自定义文字内容,如果设置了fill,插槽内容会被原生组件覆盖 |