Element UI参考手册
组件
Slider 滑块
Slider 滑块
通过拖动滑块在一个固定区间内进行选择
基础用法
在拖动滑块时,显示当前值
- 默认
- 自定义初始值
- 隐藏 Tooltip
- 格式化 Tooltip
- 禁用
通过设置绑定值自定义滑块的初始值
<template>
<div class="block">
<span class="demonstration">默认</span>
<el-slider v-model="value1"></el-slider>
</div>
<div class="block">
<span class="demonstration">自定义初始值</span>
<el-slider v-model="value2"></el-slider>
</div>
<div class="block">
<span class="demonstration">隐藏 Tooltip</span>
<el-slider v-model="value3" :show-tooltip="false"></el-slider>
</div>
<div class="block">
<span class="demonstration">格式化 Tooltip</span>
<el-slider v-model="value4" :format-tooltip="formatTooltip"></el-slider>
</div>
<div class="block">
<span class="demonstration">禁用</span>
<el-slider v-model="value5" disabled></el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value1: 0,
value2: 50,
value3: 36,
value4: 48,
value5: 42
}
},
methods: {
formatTooltip(val) {
return val / 100;
}
}
}
</script>
离散值
选项可以是离散的
- 不显示间断点
- 显示间断点
改变step
的值可以改变步长,通过设置show-step
属性可以显示间断点
<template>
<div class="block">
<span class="demonstration">不显示间断点</span>
<el-slider
v-model="value6"
:step="10">
</el-slider>
</div>
<div class="block">
<span class="demonstration">显示间断点</span>
<el-slider
v-model="value7"
:step="10"
show-stops>
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value6: 0,
value7: 0
}
}
}
</script>
带有输入框
通过输入框设置精确数值
设置show-input
属性会在右侧显示一个输入框
<template>
<div class="block">
<el-slider
v-model="value8"
show-input>
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value8: 0
}
}
}
</script>
范围选择
支持选择某一数值范围
设置range
即可开启范围选择,此时绑定值是一个数组,其元素分别为最小边界值和最大边界值
<template>
<div class="block">
<el-slider
v-model="value9"
range
show-stops
:max="10">
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value9: [4, 8]
}
}
}
</script>
竖向模式
设置vertical
可使 Slider 变成竖向模式,此时必须设置高度height
属性
<template>
<div class="block">
<el-slider
v-model="value10"
vertical
height="200px">
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value10: 0
}
}
}
</script>
Attributes
参数 |
说明 |
类型 |
可选值 |
默认值 |
---|---|---|---|---|
min |
最小值 |
number |
— |
0 |
max |
最大值 |
number |
— |
100 |
disabled |
是否禁用 |
boolean |
— |
false |
step |
步长 |
number |
— |
1 |
show-input |
是否显示输入框,仅在非范围选择时有效 |
boolean |
— |
false |
show-input-controls |
在显示输入框的情况下,是否显示输入框的控制按钮 |
boolean |
— |
true |
input-size |
输入框的尺寸 |
string |
large / medium / small / mini |
small |
show-stops |
是否显示间断点 |
boolean |
— |
false |
show-tooltip |
是否显示 tooltip |
boolean |
— |
true |
format-tooltip |
格式化 tooltip message |
function(value) |
— |
— |
range |
是否为范围选择 |
boolean |
— |
false |
vertical |
是否竖向模式 |
boolean |
— |
false |
height |
Slider 高度,竖向模式时必填 |
string |
— |
— |
label |
屏幕阅读器标签 |
string |
— |
— |
debounce |
输入时的去抖延迟,毫秒,仅在show-input等于true时有效 |
number |
— |
300 |
tooltip-class |
tooltip 的自定义类名 |
string |
— |
— |
Events
事件名称 |
说明 |
回调参数 |
---|---|---|
change |
值改变时触发(使用鼠标拖曳时,只在松开鼠标后触发) |
改变后的值 |
组件相关
Element UI 是一套采用 Vue 2.0 作为基础框架实现的组件库,一套为开发者、设计师和产品经理准备的基于 Vue 2.0 的组件库,提供了配套设计资源,帮助网站快速成型