更新记录
1.0.0(2025-03-19)
下载此版本
初始化项目
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.99 app-vue |
× |
√ |
× |
√ |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
× |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
× |
√ |
√ |
√ |
环状滑块选择器
组件名: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'"
:reservedAngle="10"
: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 |
保留的角度,用于控制滑块的结束角度,以确保最大值容易被选择 |
trackWidth |
Number |
12 |
轨道宽度,单位px |
pointSize |
Number |
12 |
滑块直径,单位px |
pointStyle |
Object |
- |
自定义滑块样式 |
fontColor |
Boolean |
true |
文字颜色 默认继承自父元素 |
Events
事件名 |
类型 |
回调参数 |
说明 |
change |
function |
value(当前值) |
松开回调事件,返回当前值 |