Slider 滑块

在固定区间内拖动选择数值。

基础用法

拖动过程中会显示当前数值。

通过 v-model 绑定数值以设置初始值。

Default value
Customized initial value
Hide Tooltip
Format Tooltip
Disabled

离散值

支持按步进离散取值。

使用 step 设置步长;show-stops 显示刻度断点。

Breakpoints not displayed
Breakpoints displayed

带输入框

通过输入框精确修改数值。

设置 show-input 在右侧显示数字输入框。

尺寸

气泡位置

可自定义 Tooltip 展示位置。

范围选择

支持选择区间。

设置 range 开启区间模式,绑定值为包含两个端点的数组。

竖直模式

设置 verticaltrue 启用竖直模式,此时必须设置 height

显示标记

通过 marks 在滑轨上显示刻度标记。

0°C
8°C
37°C
50%

限制在标记上

设置 step="mark" 使取值只能落在 marks 上。

0°C
37°C
100°C
0cm
10cm
25cm
50cm
75cm
100cm
0
13
42
58
89
100

滑块 API

滑块 属性

名称说明类型默认值
model-value / v-model绑定值number / array0
min最小值number0
max最大值number100
disabled是否禁用booleanfalse
step步长;可为数字或 'mark' 以限制只能取标记点;为 'mark' 时必须设置 marksnumber / string1
show-input是否显示输入框;rangefalsestep 不为 'mark' 时可用booleanfalse
show-input-controlsshow-inputtrue 时是否显示增减按钮booleantrue
size滑块外层尺寸;竖直模式下无效enumdefault
input-size输入框尺寸;未单独设置时继承 sizeenumdefault
show-stops是否显示断点booleanfalse
show-tooltip是否显示数值气泡booleantrue
format-tooltip自定义气泡内容格式化函数Function
range是否区间选择booleanfalse
vertical是否竖直模式booleanfalse
height滑轨高度;竖直模式下必填string
aria-label a11y原生 aria-labelstring
range-start-label区间模式下起点滑块的读屏标签string
range-end-label区间模式下终点滑块的读屏标签string
format-value-text格式化读屏 aria-valuenow 的函数Function
tooltip-classTooltip 自定义 classstring
placementTooltip 方位enumtop
marks刻度标记;键须为 number 且落在 [min, max] 闭区间内,值可为样式或自定义标签object
validate-event是否触发表单校验booleantrue
persistentTooltip 失活且 persistentfalse 时销毁 Tooltip;show-tooltipfalsepersistent 恒为 falsebooleantrue

滑块 事件

事件名说明类型
change值变化时触发(拖拽中仅在松开鼠标时触发)Function
input值变化时触发(拖拽过程中实时触发)Function

类型声明

展开类型声明
ts
type SliderMarks = Record<number, string | { style: CSSProperties; label: any }>
type Arrayable<T> = T | T[]