Slider 滑块

在固定范围内拖动滑块。

基础用法

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

通过设置绑定值来自定义滑块的初始值。

默认值
自定义初始值
隐藏提示
格式化提示
禁用状态

离散值

选项可以是离散的。

通过 step 属性设置步长。 您可以通过设置 show-stops 属性来显示间断点。

不显示间断点
显示间断点

带有输入框的滑块

通过输入框设置值。

设置 show-input 属性在右侧显示输入框。

尺寸

位置

您可以自定义提示的显示位置。

范围选择

支持选择一个数值范围。

设置 range 属性即可启用范围模式,此时绑定值是一个由两个边界值组成的数组。

垂直模式

设置 vertical 属性为 true 即可启用垂直模式。 在垂直模式下,height 属性是必填的。

显示标记

设置 marks 属性可以在滑块上显示标记。

0°C
8°C
37°C
50%

限制取值 2.13.6

设置 step="mark" 可以将滑块的值限制在标记处。

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
步长步长,可以是数字或 `'mark'` 2.13.6 用于将值限制在标记处。 当设置为 `'mark'` 时,必须设置 `marks` 属性number / string1
show-input是否显示输入框,仅在 `range` 为 false 且 `step` 不是 `'mark'` 时有效booleanfalse
show-input-controls当 `show-input` 为 true 时是否显示控制按钮booleantrue
size滑块组件的大小,在垂直模式下无效枚举default
input-size输入框的大小,若设置了 `size`,则默认值为 `size` 的值枚举default
show-stops是否显示间断点booleanfalse
show-tooltip是否显示提示值booleantrue
format-tooltip格式化提示值的显示内容Function
range是否为范围选择booleanfalse
vertical垂直模式booleanfalse
高度滑块高度,在垂直模式下必填string
aria-label a11y 2.7.2原生 aria-label 属性string
range-start-label当 `range` 为 true 时,范围起始端的屏幕阅读器标签string
range-end-label当 `range` 为 true 时,范围结束端的屏幕阅读器标签string
format-value-text格式化屏幕阅读器的 `aria-valuenow` 属性的显示内容Function
tooltip-class提示的自定义类名string
placementTooltip 的出现位置枚举
marks标记,键的类型必须为 `number` 且必须在闭区间 `[min, max]` 内,每个标记都可以自定义样式object
validate-event是否触发表单验证booleantrue
persistent 2.9.5当滑块提示处于非活动状态且 `persistent` 为 `false` 时,提示将被销毁。 当 `show-tooltip` 为 `false` 时,`persistent` 始终为 `false`。booleantrue
label a11y 已废弃原生 aria-label 属性string

事件

名称描述类型
change值改变时触发(如果是鼠标拖动,则仅在鼠标松开时触发)Function
input数据改变时触发(在滑动过程中实时触发)Function

类型声明

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

来源

组件样式文档

贡献者