Select
Selects permitem que os usuários escolham em uma lista de opções em um espaço limitado. A lista de opções pode mudar com base no contexto.
Playground
Propriedades do Select
Nome (* = obrigatório) | Tipo | Valores | Descrição |
|---|---|---|---|
addonBefore | ReactNode |
| Elemento inserido antes do campo de texto. Geralmente é um ícone. |
children | Array<Option> |
| Lista de opções (componentes “Option”) com cada uma das opções disponíveis para seleção. |
customProps | {label?: ComponentPropsWithRef<'label'>; select?: ComponentPropsWithRef<'button'>; selectWrapper?: ComponentPropsWithRef<'div'>; input?: ComponentPropsWithRef<'input'>} | Adiciona propriedades específicas para elementos filhos. | |
defaultOpen | boolean |
| Se |
defaultValue | any |
| Opção selecionada inicialmente. |
disabled | boolean |
| Se |
error | boolean |
| Se |
fullWidth | SelectFullWidth |
| Se |
helperText | ReactNode |
| Texto auxiliar que aparece abaixo do campo de texto adicionando maiores informações sobre o campo. |
id * | string |
| Propriedade ID do HTML. Vincula informações adicionais aos elementos melhorando acessibilidade. |
label | string |
| Label para descrever o campo de seleção. |
name | string |
| Nome do campo do elemento, usado no envio do formulário HTML. |
placeholder | string |
| Texto de exemplo do campo. |
required | boolean |
| Se |
value | any |
| Valor da opção selecionada. Utilizado para formulários controlados. |
Propriedades do Option
Nome (* = obrigatório) | Tipo | Valores | Descrição |
|---|---|---|---|
children | ReactNode |
| Conteúdo interno. |
disabled | boolean |
| Se |
value * | any |
| Valor da opção do campo de seleção. |
Métodos
Nome (* = obrigatório) | Tipo | Descrição |
|---|---|---|
onChange | (event: ChangeEvent<{ name?: string; value: unknown }>, child: ReactNode) => void | Função chamada quando uma opção é selecionada. |