Saltar al contenido
Logic2BUI

Buscar en la documentación

Busca componentes y documentación

Nuevo
Menú

Control deslizante

Entrada con la que el usuario selecciona un valor dentro de un intervalo.

Instalación

npx logic2b@next add slider

Uso

import { Slider } from "@/components/ui/slider"

<Slider aria-label="Volumen" defaultValue={[50]} max={100} step={1} />

Notas de uso

Está construido sobre Slider.Root de Radix. Los valores siempre son arrays: un control de un solo tirador usa [value] y un intervalo usa [start, end].

Ejemplos

Intervalo

Controlado

40

Vertical

Accesibilidad

  • Cada tirador tiene el rol slider y se puede manejar completamente con el teclado.
  • Las flechas avanzan según step; Re Pág y Av Pág usan un incremento mayor; Inicio y Fin saltan a min y max.
  • Añade un aria-label contextual o enlaza aria-labelledby con el id de una etiqueta visible para que los lectores de pantalla anuncien su finalidad.
  • En un intervalo, usa thumbLabels, por ejemplo ["Precio mínimo", "Precio máximo"], cuando los nombres numerados generados no sean suficientemente descriptivos.
  • En controles de intervalo, cada tirador recibe el foco de forma independiente y no puede cruzar al adyacente.

Playground interactivo

Edita las propiedades del componente y revisa el JSX exacto antes de copiarlo. La vista previa se carga solo cuando esta sección entra en pantalla.

JSX generado
<Slider
  defaultValue={[40]}
  min={0}
  max={100}
  aria-label="Volume"
 />

Referencia de API

Generada a partir de las exportaciones públicas de TypeScript en src/ui/slider.tsx. Las descripciones técnicas conservan el texto canónico del código fuente.

Ver JSON

Slider

Componente
Props: SliderProps
PropiedadTipoObligatoriaValor predeterminadoDescripción
minnumberNo0—
maxnumberNo100—
thumbLabelsstring[]No——
aria-labelstringNo"Slider value"—

Contrato de accesibilidad

Comportamiento legible por máquinas y responsabilidades de quien integra slider. Los detalles normativos conservan el texto canónico del registro.

Ver JSON
Soporte
Gestionado por la primitiva
Patrón
slider
Radix Slider
Interacciones de teclado para slider
TeclasComportamiento
ArrowUp ArrowDown ArrowLeft ArrowRightMove within the composite control.
Home End PageUp PageDownMove the focused thumb by the supported increment.

Semántica incorporada

  • Each thumb exposes slider value/min/max semantics and supports range sliders.

Responsabilidades de integración

  • Provide a contextual aria-label or aria-labelledby for every thumb.