Skip to content

Slider 滑块

用于在一个固定区间数值范围内通过拖动滑块进行持续调节或区间选择的控件。


代码示例

1. 基础用法 (Basic)

使用 v-model 绑定滑动数值,滑动轨道调节。

vue
<template>
  <mu-slider v-model="value" />
</template>

<script setup>
import { ref } from 'vue'
const value = ref(30)
</script>

2. 显示浮动气泡提示 (Tooltip)

设置 show-value 在拖拽按键上方显示当前分值的实时浮动提示气泡。

vue
<template>
  <mu-slider v-model="value" show-value />
</template>

3. 设定步长 (Step)

设置 step 属性控制拖拽改变时的增减步长跨度(如 step="10")。

vue
<template>
  <mu-slider v-model="value" :step="10" show-value />
</template>

4. 自定义最小值与最大值 (Min & Max)

使用 minmax 属性限制滑块允许拖动的范围界限。

vue
<template>
  <mu-slider v-model="value" :min="20" :max="80" show-value />
</template>

5. 禁用状态 (Disabled)

设置 disabled 禁止用户拖拽交互。

vue
<template>
  <mu-slider :model-value="40" disabled />
</template>

API 属性说明 (Props)

参数名说明类型可选值默认值
v-model当前滑块选择的值Number-0
min允许选择的最小值Number-0
max允许选择的最大值Number-100
step每次拖动的步长Number-1
showValue是否在按键上方展示浮动气泡数值Booleantrue | falsefalse
showValueText是否在最右侧展示数值文本Booleantrue | falsetrue
disabled是否禁用拖拽Booleantrue | falsefalse

事件说明 (Events)

事件名说明回调参数
change拖动改变数值时触发(value: Number)
update:modelValuev-model 双向绑定更新(value: Number)
drag-start开始拖拽按键时触发(value: Number)
drag-end结束拖拽释放按键时触发(value: Number)

基于 MIT 协议开源发行

H5 模拟器 (slider)☀️🔄