Skip to content

Slider 滑块 ​

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

ts
import { createApp } from 'vue'
import { ElSlider } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElSlider)

基础用法 ​

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

离散值 ​

选项可以是离散的

带有输入框的滑块 ​

通过输入框输入来改变当前的值。

不同尺寸 ​

位置 ​

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

范围选择 ​

你还可以选择一个范围值

垂直模式 ​

显示标记 ​

限制值 ​

API ​

属性 ​

属性名描述类型默认
model-value / v-model选中项绑定值number / array0
min最小值number0
max最大值number100
disabled是否禁用booleanfalse
step步长,可以是数字或 'mark',用于将值限制为刻度。 当设置为 'mark' 时,必须设置 marks 属性。number / string1
show-input是否显示输入框,仅在 range 为 false 且 step 不为 'mark' 时生效。booleanfalse
show-input-controls在显示输入框的情况下,是否显示输入框的控制按钮booleantrue
sizeslider 包装器的大小,垂直模式下该属性不可用enumdefault
input-size输入框的大小,如果设置了 size 属性,默认值自动取 sizeenumdefault
show-stops是否显示间断点booleanfalse
show-tooltip是否显示提示信息booleantrue
format-tooltip格式化提示信息Function—
range是否开启选择范围booleanfalse
vertical垂直模式booleanfalse
height滑块高度,垂直模式必填string—
aria-label a11y原生 aria-label属性string—
range-start-label当 range 为true时,屏幕阅读器标签开始的标记string—
range-end-label当 range 为true时,屏幕阅读器标签结尾的标记string—
format-value-text显示屏幕阅读器的 aria-valuenow 属性的格式Function—
tooltip-classtooltip 的自定义类名string—
placementTooltip 出现的位置enumtop
marks标记, key 的类型必须为 number 且取值在闭区间 [min, max] 内,每个标记可以单独设置样式object—
validate-event输入时是否触发表单的校验booleantrue
persistent当 slider 的 tooltip 处于非活动状态且 persistent 为 false 时,tooltip 将被销毁。 当 show-tooltip 为 false 时,persistent 将始终为 false。booleantrue
label a11y deprecated原生 aria-label属性string—

事件 ​

事件名说明类型
change值改变时触发(使用鼠标拖曳时,只在松开鼠标后触发)Function
input数据改变时触发(使用鼠标拖曳时,活动过程实时触发)Function