PrimitiveDisponible

Select

Selector personalizado con búsqueda al teclear, gestión del foco y estado seleccionado.

Loading example…

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.json

Uso

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.

PropTipoDefaultDescripción
item or nulluncontrolledControlled selected value.
function—Reports the new selection.
readonly { value: string; label: ReactNode; disabled?: boolean }[]—SelectField composes the library trigger, popup and items; items provide readable labels before the popup opens.
(value: string) => void—Controlled SelectField selection; a cleared selection returns an empty string.
boolean / string / stringfalse / — / —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.