Instalación
npx logic2b@next add sliderUso
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
slidery 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 aminymax. - Añade un
aria-labelcontextual o enlazaaria-labelledbycon 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.
Slider
ComponenteProps: SliderProps| Propiedad | Tipo | Obligatoria | Valor predeterminado | Descripción |
|---|---|---|---|---|
min | number | No | 0 | — |
max | number | No | 100 | — |
thumbLabels | string[] | No | — | — |
aria-label | string | No | "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.
- Soporte
- Gestionado por la primitiva
- Patrón
- slider
- Radix Slider
| Teclas | Comportamiento |
|---|---|
| ArrowUp ArrowDown ArrowLeft ArrowRight | Move within the composite control. |
| Home End PageUp PageDown | Move 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.