PrimitiveDisponible
Select
Selector personalizado con búsqueda al teclear, gestión del foco y estado seleccionado.
Instalación
Agrega el componente y sus dependencias desde el registro que está ejecutándose en tu computadora.
terminal
npx shadcn@latest add https://brutallab.facilito.dev/r/select.jsonUso
Importa el componente en tu proyecto y conserva el código bajo tu control.
tsx
'use client';
import { SelectField } from '@/components/ui/select';
import { Label } from '@/components/ui/label';
export default function Demo() {
return <div className="grid w-64 gap-2">
<Label htmlFor="framework-select">Framework</Label>
<SelectField id="framework-select" className="w-full" defaultValue="React"
options={['React', 'Vue', 'Svelte'].map(value => ({ value, label: value }))} />
</div>;
}
Estados e interacción
Aspecto, comportamiento y comprobación con teclado.
- Comprueba cerrado, abierto, opción resaltada, seleccionado y deshabilitado cuando el componente los admita.
- Los diálogos y menús deben poder abrirse con teclado. Escape cierra los overlays no persistentes y devuelve el foco al disparador. Tooltip y Hover Card también deben mostrarse al enfocar.
- Prueba el ejemplo con Tab y Shift+Tab. El foco debe seguir visible en ambos temas.
Referencia API
Propiedades propias de BrutalLab. También acepta los atributos nativos correspondientes.
| Prop | Tipo | Default | Descripción |
|---|---|---|---|
| value | item or null | uncontrolled | Controlled selected value. |
| onValueChange | function | — | Reports the new selection. |
| options | readonly { value: string; label: ReactNode; disabled?: boolean }[] | — | SelectField composes the library trigger, popup and items; items provide readable labels before the popup opens. |
| onValueChange | (value: string) => void | — | Controlled SelectField selection; a cleared selection returns an empty string. |
| required / name / form | boolean / string / string | false / — / — | Preserves form participation and required-value validation using the Base UI root. |
Accesibilidad
Reglas que deben conservarse cuando el componente se adapte a un producto.
Conserva las etiquetas visibles y el HTML semántico del ejemplo.
Mantén el foco visible y comprueba la composición mediante el teclado.
Personaliza el aspecto con className sin reemplazar los atributos ARIA de la primitiva.