
介绍
滑动输入条,用于在给定的范围内选择一个值。
引入
代码演示
基础用法
双滑块
添加 `range` 属性就可以开启双滑块模式,确保 `value` 的值是一个数组。
指定选择范围
禁用
指定步长
自定义样式
自定义按钮
垂直方向
设置 `vertical` 属性后,滑块会垂直展示,且高度为 100% 父元素高度。
API
Props
| 参数 | 说明 | 类型 | 默认值 | |
|---|---|---|---|---|
| value | 当前进度百分比 | number 、 array | 0 | |
| max | 最大值 | number 、 string | 100 | |
| min | 最小值 | number 、 string | 0 | |
| step | 步长 | number 、 string | 1 | |
| bar-height | 进度条高度,默认单位为px | number 、 string | 2px | |
| button-size | 滑块按钮大小,默认单位为px | number 、 string | 24px | |
| active-color | 进度条激活态颜色 | string | #1989fa | |
| inactive-color | 进度条非激活态颜色 | string | #e5e5e5 | |
range v2.10.7 | 是否开启双滑块模式 | boolean | false | |
| disabled | 是否禁用滑块 | boolean | false | |
| vertical | 是否垂直展示 | boolean | false |
Events
| 事件名 | 说明 | 回调参数 | |
|---|---|---|---|
| input | 进度变化时实时触发 | value: 当前进度 | |
| change | 进度变化且结束拖动后触发 | value: 当前进度 | |
| drag-start | 开始拖动时触发 | - | |
| drag-end | 结束拖动时触发 | - |
Slots
| 名称 | 说明 | 参数 | |
|---|---|---|---|
| button | 自定义滑动按钮 | - | |
left-button v2.12.38 | 自定义左侧滑块按钮(双滑块模式下) | { value: number } | |
right-button v2.12.38 | 自定义右侧滑块按钮(双滑块模式下) | { value: number } |
样式变量
组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考
。
| 名称 | 默认值 | 描述 | |
|---|---|---|---|
| @slider-active-background-color | @blue | - | |
| @slider-inactive-background-color | @gray-3 | - | |
| @slider-disabled-opacity | @disabled-opacity | - | |
| @slider-bar-height | 2px | - | |
| @slider-button-width | 24px | - | |
| @slider-button-height | 24px | - | |
| @slider-button-border-radius | 50% | - | |
| @slider-button-background-color | @white | - | |
| @slider-button-box-shadow | 0 1px 2px rgba(0, 0, 0, 0.5) | - |
效果图:

