更新记录
1.0.1(2026-03-30) 下载此版本
Slider 滑块组件,仿ELementUI-Slider 组件,适配微信小程序,h5,安卓app
平台兼容性
uni-app(5.05)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | × | √ | - | √ | - | √ | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | - | - | - | - | - | - | - | - | - | - | - |
基本用法 单值滑块 vue
范围滑块 vue
垂直滑块 vue
显示输入框 vue
带刻度标记 vue
Props 属性 属性名 类型 默认值 说明 value Number / Array 0 绑定值,单值时为数字,范围模式时为 [min, max] 数组 min Number 0 最小值 max Number 100 最大值 disabled Boolean false 是否禁用 step Number 1 步长 showInput Boolean false 是否显示输入框(仅非范围模式有效) showInputControls Boolean true 是否显示输入框的加减按钮(需 showInput 为 true) inputSize String 'small' 输入框尺寸,可选值:'large'、'medium'、'small'、'mini' showStops Boolean false 是否显示间断点(当 marks 存在时会自动覆盖,显示 marks 的标记点) showTooltip Boolean true 是否显示拖拽时的提示框 formatTooltip Function (val) => val 格式化提示框内容的函数,参数为当前值,返回字符串 range Boolean false 是否为范围模式(双滑块) vertical Boolean false 是否垂直布局 height String '400rpx' 垂直布局时的高度(如 '300rpx') label String '' 组件标签(暂未使用,预留) debounce Number 300 输入框防抖延迟(毫秒) tooltipClass String '' 自定义提示框的样式类 marks Object null 刻度标记,对象格式:{ 数值: '标签' } 或 { 数值: { label: '标签', style: {} } } reverse Boolean false 是否反向(值从小到大对应从右到左/从上到下) 事件 Events 事件名 参数 说明 input value: Number / Array 滑块值变化时触发(实时,拖拽过程中连续触发) change value: Number / Array 滑块值变化完成时触发(松开滑块或点击轨道后) update:value value: Number / Array 与 v-model 配合使用,同 input 方法 Methods(通过 ref 调用) 组件内部未主动暴露方法,但可以通过 ref 获取组件实例后调用以下内部方法(一般不推荐,除非有特殊需求):
方法名 说明 getTrackRect() 强制刷新轨道位置尺寸(用于布局变化后) refreshUI() 强制刷新视图 注意事项 单位:组件中使用 rpx 作为响应式单位,适配多端。
滑块位置:滑块位置基于实际 DOM 元素尺寸计算,若滑块父容器尺寸变化(如屏幕旋转),会自动重新获取轨道尺寸。
marks 与 showStops:当 marks 存在时,showStops 将被忽略,改用 marks 中的键值作为间断点。
垂直模式:垂直模式时需指定 height 属性,否则组件高度默认 400rpx。
范围模式:value 必须为数组,且长度 2,组件内部会自动排序([minVal, maxVal])。
提示框:提示框使用 fixed 定位,拖拽时会跟随滑块显示。
示例 基础单值滑块 vue
带自定义提示格式 vue
垂直范围选择 vue
带输入框和加减按钮 vue

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
赞赏(0)
下载 0
赞赏 0
下载 11440219
赞赏 1898
赞赏
京公网安备:11010802035340号