更新记录
1.0.1(2026-07-17) 下载此版本
增加最小值对应的起始角度参数配置startAngle
1.0.0(2025-03-19) 下载此版本
初始化项目
平台兼容性
uni-app(3.8.0)
| Vue2 | Vue2插件版本 | Vue3 | Vue3插件版本 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|---|---|
| √ | 1.0.0 | √ | 1.0.0 | √ | √ | √ | √ | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ |
uni-app x(3.8.0)
| Chrome | Safari | Android | Android插件版本 | iOS | iOS插件版本 | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|---|---|
| √ | √ | √ | 1.0.0 | √ | 1.0.0 | √ | √ |
环状滑块选择器
组件名:wyzh-ring-slider
安装方式
本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面
template中即可直接使用,无需在页面中import和注册components。
基本用法
在 template 中使用组件,组件尺寸继承父元素宽度
<!-- 基本使用 -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:unit="'J/cm²'"
:value="value"
@change="changeEnergy"
/>
<!-- 自定义滑块和轨道尺寸 -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:point-size="20"
:track-width="22"
:unit="'J/cm²'"
:value="value"
@change="changeEnergy"
/>
<!-- 设置轨道颜色 -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:unit="'J/cm²'"
:value="value"
track-color="blue"
@change="changeEnergy"
/>
<!-- 自定义滑块样式 -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:point-style="{backgroundColor: 'transparent', border: '6px solid #FFFFFF'}"
:unit="'J/cm²'"
:value="value"
@change="changeEnergy"
/>
<!-- 设置文字颜色 -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:unit="'J/cm²'"
:value="value"
font-color="#f5fff0"
@change="changeEnergy"
/>
<!-- 设置保留角度 -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:reserved-angle="10"
:unit="'J/cm²'"
:value="value"
@change="changeEnergy"
/>
<!-- 自定义起始角度(最小值位置) -->
<wyzh-ring-slider
:max="200"
:min="0"
:name="'Energy'"
:start-angle="90"
:unit="'J/cm²'"
:value="value"
@change="changeEnergy"
/>
API
Props
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| trackColor | String | - | 轨道颜色名称 默认为紫色,可选值:blue、green、red、yellow、orange、gray、black |
| min | Number | 0 | 最小值 |
| max | Number | 0 | 最大值 |
| name | String | - | 当前值上方的文字(为空则不显示) |
| value | Number | - | 当前值 |
| unit | String | - | 当前值下方文字(为空则不显示) |
| reservedAngle | Number | 0 | 保留的角度,用于控制滑块的结束角度,以确保最大值容易被选择 |
| startAngle | Number | 0 | 最小值对应的起始角度(0-360度),默认0度(12点钟方向),可设置为90(3点钟)、180(6点钟)、270(9点钟)等 |
| trackWidth | Number | 12 | 轨道宽度,单位px |
| pointSize | Number | 12 | 滑块直径,单位px |
| pointStyle | Object | - | 自定义滑块样式 |
| fontColor | String | inherit | 文字颜色,默认继承自父元素 |
Events
| 事件名 | 类型 | 回调参数 | 说明 |
|---|---|---|---|
| change | function | value(当前值) | 松开回调事件,返回当前值 |

收藏人数:
下载插件并导入HBuilderX
下载示例项目ZIP
赞赏(1)
下载 59
赞赏 1
下载 12477556
赞赏 1936
赞赏
京公网安备:11010802035340号