Skip to content

Slider 滑块

通过拖动滑块在一个固定区间内进行选择。

基础用法

在拖动滑块时,显示当前值。

离散值

选项可以是离散的。

带有输入框

通过输入框设置精确数值。 (需要配合 Input 组件使用,此处仅演示 Slider)

范围选择

支持选择某一数值范围。

竖向模式

展示标记

✨ 炫彩模式 (Unique)

开启 rainbow 属性,滑块条将展示动态流动的彩虹渐变效果。

💧 液体/粘滞效果 (Unique)

开启 gooey 属性,滑块按钮和进度条之间会产生粘滞(Gooey)的融合效果,提供独特的视觉反馈。建议配合较宽的 Slider 体验。

🔊 声音反馈 (Unique)

开启 sound 属性,当点击或拖动结束时,会播放轻微的机械音效,提供触觉反馈。

API

Slider 属性

属性名说明类型默认值
model-value / v-model绑定值number / number[]0
min最小值number0
max最大值number100
step步长number1
show-stops是否显示间断点booleanfalse
disabled是否禁用booleanfalse
show-tooltip是否显示 tooltipbooleantrue
format-tooltip格式化 tooltip message(val: number) => number | string
range是否开启选择范围booleanfalse
vertical是否竖向模式booleanfalse
heightSlider 高度,竖向模式必填string'200px'
marks标记,key 的类型必须为 number 且取值在闭区间 [min, max] 内,每个标记可以单独设置样式object
rainbow是否开启炫彩模式booleanfalse
gooey是否开启液体粘滞效果booleanfalse
sound是否开启声音反馈booleanfalse

Slider 事件

事件名说明回调参数
change值改变时触发(使用鼠标拖拽时,只在松开鼠标后触发)val: number | number[]
input数据改变时触发(使用鼠标拖拽时,活动过程实时触发)val: number | number[]