Slider

Desliza el slider dentro de un rango fijo.

TIP

Este componente requiere el envoltorio <client-only></client-only> cuando se utiliza en SSR (por ejemplo: Nuxt) y SSG (por ejemplo: VitePress).

Uso básico

El valor actual se muestra cuando se inicia el arrastre del slider.

Valores discretos

Las opciones pueden ser discretas.

Slider con input

Establecer valor a través de una casilla de entrada.

Tamaños

Posición

Puede personalizar el posicionamiento del tooltip.

Selección de rangos

La selección de un rango de valores es soportado.

Modo Vertical

Mostrar marcas

API

Atributos

NombreDescriciónTipoDefault
model-value / v-modelvalor vinculadonumber / object0
minvalor mínimonumber0
maxvalor máximonumber100
disabledsi el Slider esta deshabitadobooleanfalse
steptamaño del pasonumber1
show-inputSi se muestra el input, trabaja cuando rangees falsebooleanfalse
show-input-controlssi se muestran los botones de control cuandoshow-inputes truebooleantrue
sizeel tamaño del envoltorio del slider no funcionará en modo verticalenumdefault
input-sizetamaño del input, cuando se establece size, el valor por defecto es sizeenumdefault
show-stopssi se muestran los puntos de ruptura (breakpoints)booleanfalse
show-tooltipsi se muestra el valor en un tooltipbooleantrue
format-tooltipformato para mostrar el valor del tooltipFunction
rangesi se usaran un rangobooleanfalse
verticalmodo verticalbooleanfalse
heightslider height, required in vertical modestring
label a11y deprecatednative aria-label attributestring
aria-label a11y 2.7.2native aria-label attributestring
range-start-labelcuando range es true, etiqueta el lector de pantalla hacia el inicio del rangostring
range-end-labelcuando range es true, etiqueta el lector de pantalla hacia el final del rangostring
format-value-textformato para mostrar el atributo aria-valuenow para lectores de pantallaFunction
debounceretardo al escribir, en milisegundos, funciona cuandoshow-input es true.number300
tooltip-classnombre personalizado de clase para el tooltipstring
placementposición del Tooltipenumtop
marksmarcas, tipo de clave debe ser number y debe estar en intervalo cerrado [min, max], cada marca puede tener estilo personalizadoobject
validate-eventsi se debe activar la validación del formulariobooleantrue

Eventos

NombreDescripciónType
changese 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
inputse 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

ComponentesDocumentación

Contribuidores