本文主要是介绍vue element plus Slider 滑块,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
通过拖动滑块在一个固定区间内进行选择
TIP
在 SSR 场景下,您需要将组件包裹在 <client-only></client-only>
之中 (如: Nuxt) 和 SSG (e.g: VitePress).
基础用法#
在拖动滑块时,显示当前值
通过设置绑定值自定义滑块的初始值
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%
API#
属性#
属性名 | 描述 | 类型 | 默认 |
---|---|---|---|
model-value / v-model | 选中项绑定值 | number / object | 0 |
min | 最小值 | number | 0 |
max | 最大值 | number | 100 |
disabled | 是否禁用 | boolean | false |
step | 步长 | number | 1 |
show-input | 是否显示输入框,仅在非范围选择时有效 | boolean | false |
show-input-controls | 在显示输入框的情况下,是否显示输入框的控制按钮 | boolean | true |
size | slider 包装器的大小,垂直模式下该属性不可用 | enum | default |
input-size | 输入框的大小,如果设置了 size 属性,默认值自动取 size | enum | default |
show-stops | 是否显示间断点 | boolean | false |
show-tooltip | 是否显示提示信息 | boolean | true |
format-tooltip | 格式化提示信息 | Function | — |
range | 是否开启选择范围 | boolean | false |
vertical | 垂直模式 | boolean | false |
height | 滑块高度,垂直模式必填 | string | — |
label | 屏幕阅读器标签 | string | — |
range-start-label | 当 range 为true时,屏幕阅读器标签开始的标记 | string | — |
range-end-label | 当 range 为true时,屏幕阅读器标签结尾的标记 | string | — |
format-value-text | 显示屏幕阅读器的 aria-valuenow 属性的格式 | Function | — |
debounce | 输入时的去抖延迟,毫秒,仅在 show-input 等于 true 时有效 | number | 300 |
tooltip-class | tooltip 的自定义类名 | string | — |
placement | Tooltip 出现的位置 | enum | top |
marks | 标记, key 的类型必须为 number 且取值在闭区间 [min, max] 内,每个标记可以单独设置样式 | object | — |
validate-event | 输入时是否触发表单的校验 | boolean | true |
事件#
事件名 | 说明 | 类型 |
---|---|---|
change | 值改变时触发(使用鼠标拖曳时,只在松开鼠标后触发) | Function |
input | 数据改变时触发(使用鼠标拖曳时,活动过程实时触发) | Function |
类型声明#
显示类型声明
源代码#
组件 • 文档
这篇关于vue element plus Slider 滑块的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!