# 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 |