Slider 滑块
WebH5
滑块。通过拖拽或键盘在区间内取值,pointer 事件实现桌面与移动端一致的拖拽体验。
何时使用
在连续区间内直观取值:音量、亮度、价格范围。
何时不使用
精确数值且范围很大时用 Input type=number;离散选项用 RadioGroup。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | 0 | 当前值(v-model) |
min | number | 0 | 最小值 |
max | number | 100 | 最大值 |
step | number | 1 | 步进,取值自动对齐 |
disabled | boolean | false | 禁用 |
showTooltip | boolean | true | 拖动时显示当前值气泡 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | number | 值变化时触发(v-model),拖动过程中持续触发 |
change | number | 拖动结束(pointerup)或键盘步进时触发一次 |
示例
基础
示例加载中…
<Stack :gap="8">
<span>音量</span>
<Slider v-model="volume" />
</Stack>区间与步进
示例加载中…
<Stack :gap="8">
<span>预算上限(0–1000 元,步进 50)</span>
<Slider v-model="price" :min="0" :max="1000" :step="50" />
</Stack>禁用
示例加载中…
<Slider :model-value="30" disabled />Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Slider 文档(含手机预览)。