Ir al contenido

Slider

Control deslizante para elegir un valor o un rango entre dos límites.

Navegadores
Chrome 123+Firefox 121+Safari 17.5+
Nivel
0
Tamaño comprimido
465 B
Presupuesto de diseño forzado
0 ms
Presupuesto de axe
0
Compatible con SSR
Sí
Contrato publicado
Entorno de pruebas

Zona de pruebas

Slider

Slider predeterminado

Slider controlado

Slider con marcas

Slider de rango

Slider vertical

Slider desactivado

API

Slider

PropTipoPredeterminadoDescripción
valuenumber—Valor actual; hace que el control deslizante sea controlado.
defaultValuenumber—Valor inicial del control deslizante no controlado; luego lo gestiona el input nativo de tipo range.
onValueChange(value: number) => void—Se llama con el nuevo número cada vez que se mueve el control deslizante.
minnumber0Valor mínimo que se puede seleccionar.
maxnumber100Valor máximo que se puede seleccionar.
stepnumber1Incremento entre valores seleccionables.
disabledbooleanfalseDesactiva el input nativo y establece el atributo data-disabled.
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

SliderClient

PropTipoPredeterminadoDescripción
valuenumber | readonly [number, number]—Valor controlado; una tupla renderiza un control inferior y otro superior.
defaultValuenumber | readonly [number, number]—Valor inicial del input nativo de tipo range o del rango de dos controles.
onValueChange(value: number | readonly [number, number]) => void—Se llama cuando cambia el valor seleccionado o el rango ordenado.
minnumber0Valor mínimo que se puede seleccionar.
maxnumber100Valor máximo que se puede seleccionar.
stepnumber | null1Un step numérico conserva los incrementos nativos antes de la hidratación; null restringe los valores a min, max y las marcas después de la hidratación.
marksreadonly { value: number; label?: ReactNode }[]—Etiquetas de marcas y puntos de ajuste cuando step es null.
orientation"horizontal" | "vertical""horizontal"Dirección de la distribución del control y sus marcas.
thumbLabelsreadonly [string, string]—Nombres accesibles de los controles inferior y superior del rango.
disabledbooleanfalseDesactiva todos los inputs nativos de tipo range.
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

Teclado

TeclaAcción
Arrow keysAjustar el input nativo de tipo range con foco en un incremento o punto de ajuste
Home / EndMover el control con foco al mínimo o al máximo
TabMoverse entre los controles inferior y superior del rango

Accesibilidad

Slider renderiza un input nativo de tipo range que funciona antes de la hidratación y con JavaScript desactivado. SliderClient también renderiza inputs nativos de tipo range en el servidor y los controla después de la hidratación para valores de rango, marcas etiquetadas y ajustes no uniformes. Un step numérico conserva los incrementos nativos antes de la hidratación; el ajuste a marcas con step={null} comienza después de la hidratación. Dale a un control deslizante único un aria-label o aria-labelledby; dale thumbLabels a ambos controles de rango.

Puntos de estilo

data-uiify-sliderdata-uiify-slider-clientdata-part="root"data-part="track"data-part="range"data-part="mark"data-part="thumb"data-orientationdata-disableddata-enhanced--uiify-slider-start--uiify-slider-end--uiify-slider-position
Esta página se tradujo automáticamente y aún no se ha revisado.