更新记录
1.0.0(2025-05-28)
下载此版本
v1.0.0
- 首次发布仪表盘进度条组件。
- 支持多段颜色区间配置(colorSections)。
- 支持动态指针、中心数值与描述文本展示。
- 支持自定义外环颜色、背景色、尺寸、canvasId。
- 响应 value 和 size 变化自动重绘。
- 优化刻度与指针渲染,提升性能与视觉效果。
平台兼容性
uni-app
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
√ |
- |
- |
- |
√ |
- |
- |
- |
- |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
√ |
- |
√ |
- |
- |
- |
- |
- |
- |
- |
- |
tzx-gauge-progress 仪表盘进度条组件
组件简介
tzx-gauge-progress
是一个基于 canvas 实现的仪表盘进度条组件,支持多段颜色、动态指针、中心数值与描述文本展示,适用于 UniApp 项目。
tzx-gauge-progress 组件 API 说明
属性(Props)
属性名 |
类型 |
默认值 |
说明 |
value |
Number |
0 |
当前进度值,范围 0~100 |
title |
String |
"" |
仪表盘中心下方描述文本 |
size |
Number |
350 |
仪表盘宽高(px) |
valueColor |
String |
"#333" |
中心数值及描述文本颜色 |
canvasId |
String |
"gaugeCanvas" |
canvas 画布 id |
colorSections |
Array |
[{max:10,color:'#F44336'},{max:80,color:'#1DE9F3'},{max:100,color:'#00FF00'}] |
刻度区间及颜色配置,按 max 升序排列 |
outerRingColor |
String |
"#F44336" |
外环进度部分颜色 |
outerRingBgColor |
String |
"#444" |
外环未达进度部分颜色 |
colorSections 详细说明
- 类型:Array<{max:Number, color:String}>
- 作用:定义不同进度区间的刻度和文字颜色。例如:
{max:10, color:'#F44336'}
表示 0~10 区间为红色
{max:80, color:'#1DE9F3'}
表示 10~80 区间为蓝色
{max:100, color:'#00FF00'}
表示 80~100 区间为绿色
- 注意:max 必须递增,最后一个 max 应为 100
示例
<tzx-gauge-progress
:value="70"
title="进度"
:size="350"
valueColor="#333"
:colorSections="[{max:10,color:'#F44336'},{max:80,color:'#1DE9F3'},{max:100,color:'#00FF00'}]"
outerRingColor="#F44336"
outerRingBgColor="#444"
/>