Slider
Desliza el slider dentro de un rango fijo.
Uso básico
El valor actual se muestra cuando se inicia el arrastre del slider.
Personalice el valor inicial del slider configurando el valor vinculado.
Valores discretos
Las opciones pueden ser discretas.
Configure el tamaño del paso con el atributo step
. Puede visualizar los puntos de ruptura configurando el atributo show-stops
.
Slider con input
Establecer valor a través de una casilla de entrada.
Establece el atributo show-input
para mostrar un cuadro de entrada a la derecha.
Tamaños
Posición
Puede personalizar el posicionamiento del tooltip.
Selección de rangos
La selección de un rango de valores es soportado.
Configurando el atributo range
activa el modo de rango, donde el valor de enlace es un arreglo formado por dos valores límites.
Modo Vertical
Configurando el atributo vertical
a true
habilita el modo vertical. En modo vertical, se requiere el atributo height
.
Mostrar marcas
Use el atributo marks
para mostrar marcas en el slider.
API
Atributos
Nombre | Descrición | Tipo | Default |
---|---|---|---|
model-value / v-model | valor vinculado | number / object | 0 |
min | valor mínimo | 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 cuandoshow-input es true | boolean | true |
size | el tamaño del envoltorio del slider no funcionará en modo vertical | enum | default |
input-size | tamaño del input, cuando se establece size , el valor por defecto es size | enum | default |
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 | — |
range | si se usaran un rango | boolean | false |
vertical | modo vertical | boolean | false |
height | slider height, required in vertical mode | string | — |
aria-label a11y 2.7.2 | native aria-label attribute | string | — |
range-start-label | cuando range es true, etiqueta el lector de pantalla hacia el inicio del rango | string | — |
range-end-label | cuando range es true, etiqueta el lector de pantalla hacia el final del rango | string | — |
format-value-text | formato para mostrar el atributo aria-valuenow para lectores de pantalla | Function | — |
debounce | retardo al escribir, en milisegundos, funciona cuandoshow-input es true. | number | 300 |
tooltip-class | nombre personalizado de clase para el tooltip | string | — |
placement | posición del Tooltip | enum | top |
marks | marcas, tipo de clave debe ser number y debe estar en intervalo cerrado [min, max] , cada marca puede tener estilo personalizado | object | — |
validate-event | si se debe activar la validación del formulario | boolean | true |
label a11y deprecated | native aria-label attribute | string | — |
Eventos
Nombre | Descripción | Type |
---|---|---|
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) | Function |
input | se dispara cuando los datos cambian (se emitirá en tiempo real durante el deslizamiento) | Function |
Type Declarations
Show declarations
type SliderMarks = Record<number, string | { style: CSSProperties; label: any }>
type Arrayable<T> = T | T[]
Fuente
Componentes • Style • Documentación