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 开启区间模式,绑定值为包含两个端点的数组。

竖直模式 ​

设置 vertical 为 true 启用竖直模式,此时必须设置 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是否显示输入框;range 为 false 且 step 不为 'mark' 时可用booleanfalse
show-input-controlsshow-input 为 true 时是否显示增减按钮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 失活且 persistent 为 false 时销毁 Tooltip;show-tooltip 为 false 时 persistent 恒为 falsebooleantrue

滑块 事件 ​

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

类型声明 ​

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