Slider 滑块

在固定范围内拖动滑块。

基础用法

拖动滑块时显示当前值。

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

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

离散值

选项可以是离散的。

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

不显示断点
显示断点

带输入框的滑块

通过输入框设置值。

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

尺寸

位置

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

范围选择

支持选择一个值的范围。

设置 range 属性会激活范围模式,其中绑定值是由两个边界值组成的数组。

垂直模式

vertical 属性设置为 true 可启用垂直模式。在垂直模式下,需要 height 属性。

显示标记

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

0°C
8°C
37°C
50%

API

属性

名称描述类型默认值
model-value / v-model绑定值number / object0
min最小值number0
max最大值number100
disabled滑块是否被禁用booleanfalse
步长步长number1
show-input是否显示输入框,仅在 range 为 false 时有效booleanfalse
show-input-controlsshow-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-labelrange 为 true 时,范围开始的屏幕阅读器标签string
range-end-labelrange 为 true 时,范围结束的屏幕阅读器标签string
format-value-text格式化屏幕阅读器的 `aria-valuenow` 属性的显示Function
防抖输入时的防抖延迟,单位为毫秒,在 `show-input` 为 true 时有效number300
tooltip-classTooltip 的自定义类名string
placementTooltip 的出现位置枚举
marks标记,键的类型必须是 `number` 且必须在闭合区间 `[min, max]` 内,每个标记都可以自定义样式object
validate-event是否触发表单验证booleantrue
persistent 2.9.5当滑块提示不活动且 `persistent` 为 `false` 时,popconfirm 将被销毁。当 `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[]

来源

组件样式文档

贡献者