Slider 滑块
uni-appH5微信小程序App
封装 uni-app 原生 slider 的跨端数值滑块。
何时使用
在连续区间内直观取值:音量、亮度、价格范围。
何时不使用
精确数值且范围很大时用 Input type=number;离散选项用 RadioGroup。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
Slider 滑块 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | 0 | 当前值(v-model) |
min | number | 0 | 最小值 |
max | number | 100 | 最大值 |
step | number | 1 | 步进,取值自动对齐 |
disabled | boolean | false | 禁用 |
showValue | boolean | false | 滑块上方常驻显示当前值 |
activeColor | string | "#3b6ef6" | 滑块激活段颜色 |
backgroundColor | string | "#e5e7eb" | 滑块轨道底色 |
blockSize | number | 20 | 滑块手柄尺寸,单位 px |
showTooltip | boolean | true | 拖动时显示当前值气泡 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | number | 值变化时触发(v-model),拖动过程中持续触发 |
change | number | 拖动结束(pointerup)或键盘步进时触发一次 |
示例
基础用法
vue
<Slider v-model="volume" />显示当前值
vue
<Slider v-model="volume" show-value />步长与禁用
vue
<Slider v-model="range1" :step="10" />
<Slider v-model="range1" disabled style="margin-top:14px" />拖动气泡提示
vue
<Slider v-model="volume" show-tooltip />