# Slider 滑块
# Slider 概述
滑动输入器,用于在数值区间/自定义区间内进行选择,支持连续或离散值。
# Slider 代码示例
# 基础用法
滑块的基本用法,可以使用 v-model 双向绑定数据。
通过设置属性 range
开启双滑块,通过设置属性 disabled
禁用滑块。
注意,单滑块时,value
格式为数字,当开启双滑块时,value
为长度是 2 的数组,且每项为数字。
# 离散值
通过设置属性 step
可以控制每次滑动的间隔。
通过设置属性 min
可以控制最小值。
通过设置属性 max
可以控制最大值。
# 显示间断点
通过设置属性 show-stops
可以显示间断点,建议在 step
间隔不密集时使用。
# 带有输入框
通过设置属性 show-input
可以显示数字输入框,配合使用,仅在单滑块模式下有效。
# 自定义提示
Slider 会把当前值传给 tip-format
,并在 Tooltip 中显示 tip-format 的返回值,若为 null,则隐藏 Tooltip。
show-tip
提示的显示控制,可选值为 hover(悬停,默认)、always(总是可见)、never(不可见),默认值为 hover。
# 绑定事件
on-change
在松开滑动时触发,返回当前的选值,在滑动过程中不会触发。
on-input
滑动条数据变化时触发,返回当前的选值,在滑动过程中实时触发。
# Slider API
# Slider props
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
value | 滑块选定的值,可以使用 v-model 双向绑定数据。普通模式下,数据格式为数字,在双滑块模式下,数据格式为长度是 2 的数组,且每项都为数字 | Number | Array | 0 |
min | 最小值 | Number | 0 |
max | 最大值 | Number | 100 |
step | 步长,取值建议能被 (max - min)整除 | Number | 1 |
disabled | 是否禁用滑块 | Boolean | false |
range | 是否开启双滑块模式 | Boolean | false |
show-input | 是否显示数字输入框,仅在单滑块模式下有效 | Boolean | false |
show-stops | 是否显示间断点,建议在 step 不密集时使用 | Boolean | false |
show-tip | 提示的显示控制,可选值为 hover (悬停,默认)、always (总是可见)、never (不可见) | String | hover |
tip-format | Slider 会把当前值传给 tip-format ,并在 Tooltip 中显示 tip-format 的返回值,若为 null,则隐藏 Tooltip | Function | value |
# Slider events
事件名 | 说明 | 返回值 |
---|---|---|
on-change | 在松开滑动时触发,返回当前的选值,在滑动过程中不会触发 | value |
on-input | 滑动条数据变化时触发,返回当前的选值,在滑动过程中实时触发 | value |