项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。开发迭代中,请勿用于生产环境。
Skip to content
仅桌面端保证样式

Slider 滑块 ​

EvSlider 在小范围内选取数值:音量、透明度、磨砂强度这类连续参数。原生 range 之上的 受控封装,键盘方向键可调,导轨「已走过」的部分着主色;提供三种尺寸与禁用态。 不绑定 v-model 时组件自持状态(default-value 定初值),复制标签即可拖动。

基础用法 ​

绑定 v-model
拖动即派发 update:modelValue 与 change,数值实时回显;范围与步长用 min / max / step 控制。

音量:30

比例:0.50

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

<template>
  <EvSlider v-model="volume" :min="0" :max="100" />
  <EvSlider v-model="ratio" :min="0" :max="1" :step="0.05" />
</template>

尺寸与禁用 ​

small / default / large / disabled
各滑块均可拖动(禁用态除外),未绑定 v-model 时独立自持状态。
vue
<EvSlider size="small" :default-value="20" />
<EvSlider :default-value="45" />
<EvSlider size="large" :default-value="70" />
<EvSlider disabled :default-value="60" />

API ​

Props ​

属性说明类型默认值
v-model当前值number0
default-value非受控模式的初始值(未绑定 v-model 时生效)number—
min最小值number0
max最大值number100
step步长number1
disabled禁用booleanfalse
size尺寸'small' | 'default' | 'large''default'

事件 ​

事件说明参数
update:modelValue拖动时持续派发number
change拖动时持续派发number

aria-label 等原生属性会透传到内部 input 上(单独使用时建议补一个可读名称)。

初始值不必落在步长格点上:不在 min + k·step 上的值会就近吸附显示(如 min=30、 step=5 的 72 显示为 70),圆钮与导轨填充始终一致;拖动派发的一律是格点值。

基于 MIT 许可证发布