ITpS

Componentes

Select

Combobox custom (ARIA 1.2). Trigger pill + listbox flutuante com title/description. Keyboard nav completo.

Default

Trigger fechado com placeholder. Click ou Enter/Space abre o painel.

Com descrições

Cada opção pode trazer um subtítulo. Útil quando o label sozinho não basta.

Sizes

Três alturas alinhadas ao token form-height.

Estados

Com Field

Padrão real: envolva no Field para label + erro.

Acessibilidade

  • role="combobox" no trigger, role="listbox" no painel, role="option" em cada item
  • aria-expanded, aria-controls, aria-activedescendant ligados via id
  • Keyboard: Enter/Space/ArrowDown abre, ↑/↓ navegam, Home/End vão pra extremos, Enter/Space selecionam, Escape fecha
  • Click fora fecha, foco volta pro trigger

Props

PropTipoDefaultDescrição
idstringautoID do trigger.
namestringname HTML do input hidden.
optionsOption[]obrigatórioLista de opções.
valuestringValor selecionado inicial.
placeholderstring'Selecione uma opção'Texto quando vazio.
disabledbooleanfalseBloqueia interação.
requiredbooleanfalseMarca como obrigatório.
invalidbooleanfalseBorda vermelha.
size'sm' | 'md' | 'lg''md'Altura.
leftIconstringMaterial Symbol antes.
classstringClasses adicionais.

Option

PropTipoDescrição
valuestringValor submetido.
labelstringTexto principal.
descriptionstringSubtítulo opcional.