element/examples/docs/es/slider.md

205 lines
5.8 KiB
Markdown
Raw Normal View History

2017-11-06 19:22:02 +08:00
## Slider
2017-11-15 01:33:49 +08:00
Desliza el slider dentro de un rango fijo.
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
### Uso básico
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
El valor actual se muestra cuando se inicia el arrastre del slider.
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
:::demo Personalice el valor inicial del slider configurando el valor vinculado.
2017-11-06 19:22:02 +08:00
```html
<template>
<div class="block">
<span class="demonstration">Default value</span>
<el-slider v-model="value1"></el-slider>
</div>
<div class="block">
<span class="demonstration">Customized initial value</span>
<el-slider v-model="value2"></el-slider>
</div>
<div class="block">
<span class="demonstration">Hide Tooltip</span>
<el-slider v-model="value3" :show-tooltip="false"></el-slider>
</div>
<div class="block">
<span class="demonstration">Format Tooltip</span>
<el-slider v-model="value4" :format-tooltip="formatTooltip"></el-slider>
</div>
<div class="block">
<span class="demonstration">Disabled</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>
```
:::
2017-11-15 01:33:49 +08:00
### Valores discretos
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
Las opciones pueden ser discretas.
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
:::demo Configure el tamaño del paso con el atributo `step`. Puede visualizar los puntos de ruptura configurando el atributo `show-stops`.
2017-11-15 01:33:49 +08:00
2017-11-06 19:22:02 +08:00
```html
<template>
<div class="block">
<span class="demonstration">Breakpoints not displayed</span>
<el-slider
v-model="value6"
:step="10">
</el-slider>
</div>
<div class="block">
<span class="demonstration">Breakpoints displayed</span>
<el-slider
v-model="value7"
:step="10"
show-stops>
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value6: 0,
value7: 0
}
}
}
</script>
```
:::
2017-11-15 01:33:49 +08:00
### Slider con input
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
Inserte el valor a traves de un input
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
:::demo Configure el atributo `show-input` para que muestre un input a la derecha.
2017-11-06 19:22:02 +08:00
```html
<template>
<div class="block">
<el-slider
v-model="value8"
show-input>
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value8: 0
}
}
}
</script>
```
:::
2017-11-15 01:33:49 +08:00
### Seleccion de rangos
Se soporta la selección de un rango de valores.
2017-11-06 19:22:02 +08:00
2017-11-15 01:33:49 +08:00
:::demo El ajuste del atributo `range` activa el modo range, donde el valor vinculado es un array compuesto por dos valores límite.
2017-11-06 19:22:02 +08:00
```html
<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>
```
:::
2017-11-15 01:33:49 +08:00
### Modo Vertical
:::demo El ajuste del atributo `vertical` a `true` habilita el modo vertical. En el modo vertical, se requiere el atributo `height` .
2017-11-06 19:22:02 +08:00
```html
<template>
<div class="block">
<el-slider
v-model="value10"
vertical
height="200px">
</el-slider>
</div>
</template>
<script>
export default {
data() {
return {
value10: 0
}
}
}
</script>
```
:::
2017-11-15 01:33:49 +08:00
## Atributos
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| ------------------- | ---------------------------------------- | --------------- | ----------------- | ----------- |
| value / v-model | valor enlazado | number | — | 0 |
2017-11-15 01:33:49 +08:00
| min | valor minimo | number | — | 0 |
| max | valor máximo | number | — | 100 |
| disabled | si el Slider esta deshabitado | boolean | — | false |
| step | tamaño del paso | number | — | 1 |
| show-input | Si se muestra el input, trabaja cuando`range`es false | boolean | — | false |
| show-input-controls | si se muestran los botones de control cuando`show-input`es true | boolean | — | true |
| input-size | tamaño del input | string | large / medium / small / mini | small |
2017-11-15 01:33:49 +08:00
| show-stops | si se muestran los puntos de ruptura (breakpoints) | boolean | — | false |
| show-tooltip | si se muestra el valor en un tooltip | boolean | — | true |
| format-tooltip | formato para mostrar el valor del tooltip | function(value) | — | — |
| range | si se usaran un rango | boolean | — | false |
| vertical | modo vertical | boolean | — | false |
| height | alto del Slider, requerido en modo vertical | string | — | — |
| label | etiqueta para screen reader | string | — | — |
| debounce | retardo al escribir, en milisegundos, funciona cuando`show-input` es true. | number | — | 300 |
2018-03-02 20:36:45 +08:00
| tooltip-class | nombre personalizado de clase para el tooltip | string | — | — |
2017-11-15 01:33:49 +08:00
## Eventos
| Nombre | Descripción | Parametros |
| ------ | ---------------------------------------- | ------------------------ |
| change | se dispara cuando el valor cambia (si el ratón está comenzando el arrastre este evento sólo se disparara cuando se suelte el ratón) | valor despues del cambio |
2017-11-06 19:22:02 +08:00