element/examples/docs/zh-CN/slider.md

199 lines
4.0 KiB
Markdown
Raw Normal View History

2016-07-27 06:15:02 +00:00
<script>
export default {
2016-08-11 07:51:13 +00:00
data() {
return {
value1: 0,
value2: 50,
2017-03-18 07:17:18 +00:00
value3: 36,
value4: 42,
value5: 0,
2017-02-17 11:09:59 +00:00
value6: 0,
2017-03-18 07:17:18 +00:00
value7: 0,
value8: [4, 8]
2016-08-11 07:51:13 +00:00
};
2016-07-27 06:15:02 +00:00
}
}
</script>
2016-08-27 08:06:22 +00:00
<style>
.demo-box.demo-slider .source {
padding: 0;
}
2016-08-27 08:06:22 +00:00
.demo-box.demo-slider .block {
padding: 30px 24px;
overflow: hidden;
border-bottom: solid 1px #EFF2F6;
&:last-child {
border-bottom: none;
2016-08-27 08:06:22 +00:00
}
}
2016-08-27 08:06:22 +00:00
.demo-box.demo-slider .demonstration {
font-size: 14px;
color: #8492a6;
line-height: 44px;
}
2016-08-27 08:06:22 +00:00
.demo-box.demo-slider .demonstration + .el-slider {
float: right;
width: 70%;
margin-right: 20px;
}
</style>
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
## Slider 滑块
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
通过拖动滑块在一个固定区间内进行选择
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
### 基础用法
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
在拖动滑块时,显示当前值
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
:::demo 通过设置绑定值自定义滑块的初始值
2016-07-27 06:15:02 +00:00
```html
2016-08-27 08:06:22 +00:00
<template>
<div class="block">
<span class="demonstration">默认</span>
<el-slider v-model="value1"></el-slider>
2016-08-27 08:06:22 +00:00
</div>
<div class="block">
<span class="demonstration">自定义初始值</span>
<el-slider v-model="value2"></el-slider>
</div>
2017-03-18 07:17:18 +00:00
<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">禁用</span>
2017-03-18 07:17:18 +00:00
<el-slider v-model="value4" disabled></el-slider>
</div>
2016-08-27 08:06:22 +00:00
</template>
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
<script>
export default {
data() {
return {
value1: 0,
2016-11-08 07:59:02 +00:00
value2: 50,
2017-03-18 07:17:18 +00:00
value3: 36,
value4: 42
2016-08-27 08:06:22 +00:00
}
}
}
</script>
2016-07-27 06:15:02 +00:00
```
2016-08-27 08:06:22 +00:00
:::
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
### 离散值
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
选项可以是离散的
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
:::demo 改变`step`的值可以改变步长,通过设置`show-step`属性可以显示间断点
2016-07-27 06:15:02 +00:00
```html
2016-08-27 08:06:22 +00:00
<template>
<div class="block">
<span class="demonstration">不显示间断点</span>
<el-slider
2017-03-18 07:17:18 +00:00
v-model="value5"
2016-08-27 08:06:22 +00:00
:step="10">
</el-slider>
2016-08-27 08:06:22 +00:00
</div>
<div class="block">
<span class="demonstration">显示间断点</span>
<el-slider
2017-03-18 07:17:18 +00:00
v-model="value6"
2016-08-27 08:06:22 +00:00
:step="10"
show-stops>
</el-slider>
</div>
</template>
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
<script>
export default {
data() {
return {
2017-03-18 07:17:18 +00:00
value5: 0,
value6: 0
2016-08-27 08:06:22 +00:00
}
}
}
</script>
2016-07-27 06:15:02 +00:00
```
2016-08-27 08:06:22 +00:00
:::
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
### 带有输入框
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
通过输入框设置精确数值
2016-07-27 06:15:02 +00:00
2016-08-27 08:06:22 +00:00
:::demo 设置`show-input`属性会在右侧显示一个输入框
2016-07-27 06:15:02 +00:00
```html
2016-08-27 08:06:22 +00:00
<template>
<div class="block">
<el-slider
2017-03-18 07:17:18 +00:00
v-model="value7"
2016-08-27 08:06:22 +00:00
show-input>
</el-slider>
2016-08-27 08:06:22 +00:00
</div>
</template>
<script>
export default {
data() {
return {
2017-03-18 07:17:18 +00:00
value7: 0
2016-08-27 08:06:22 +00:00
}
}
}
</script>
2016-07-27 06:15:02 +00:00
```
2016-08-27 08:06:22 +00:00
:::
2016-07-27 06:15:02 +00:00
2017-02-17 11:09:59 +00:00
### 范围选择
支持选择某一数值范围
:::demo 设置`range`即可开启范围选择,此时绑定值是一个数组,其元素分别为最小边界值和最大边界值
```html
<template>
<div class="block">
<el-slider
2017-03-18 07:17:18 +00:00
v-model="value8"
2017-02-17 11:09:59 +00:00
range
show-stops
:max="10">
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
2017-03-18 07:17:18 +00:00
value8: [4, 8]
2017-02-17 11:09:59 +00:00
}
}
}
</script>
```
:::
2016-12-15 07:15:46 +00:00
### Attributes
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
2016-09-02 05:56:47 +00:00
| min | 最小值 | number | — | 0 |
| max | 最大值 | number | — | 100 |
| disabled | 是否禁用 | boolean | — | false |
2016-09-02 05:56:47 +00:00
| step | 步长 | number | — | 1 |
2017-02-17 11:09:59 +00:00
| show-input | 是否显示输入框,仅在非范围选择时有效 | boolean | — | false |
| show-input-controls | 在显示输入框的情况下,是否显示输入框的控制按钮 | boolean | — | true|
2016-09-02 05:56:47 +00:00
| show-stops | 是否显示间断点 | boolean | — | false |
2017-03-18 07:17:18 +00:00
| show-tooltip | 是否显示 tooltip | boolean | — | true |
2017-02-17 11:09:59 +00:00
| range | 是否为范围选择 | boolean | — | false |
2016-08-27 08:06:22 +00:00
2016-12-15 07:15:46 +00:00
### Events
2016-08-27 08:06:22 +00:00
| 事件名称 | 说明 | 回调参数 |
|---------- |-------- |---------- |
2016-12-31 10:16:08 +00:00
| change | 值改变时触发(使用鼠标拖曳时,只在松开鼠标后触发) | 改变后的值 |