跳到主要内容

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 ​

名称类型默认值说明
modelValuenumber0当前值(v-model)
minnumber0最小值
maxnumber100最大值
stepnumber1步进,取值自动对齐
disabledbooleanfalse禁用
showValuebooleanfalse滑块上方常驻显示当前值
activeColorstring"#3b6ef6"滑块激活段颜色
backgroundColorstring"#e5e7eb"滑块轨道底色
blockSizenumber20滑块手柄尺寸,单位 px
showTooltipbooleantrue拖动时显示当前值气泡

Events ​

名称载荷说明
update:modelValuenumber值变化时触发(v-model),拖动过程中持续触发
changenumber拖动结束(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 />