更新记录

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(当前值) 松开回调事件,返回当前值

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议