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 &ldquo;Option&rdquo;) 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

    • false (default)

    • true

    Se true, a lista de opções (popover) é inicializada aberta.

    defaultValue

    any

    • -

    Opção selecionada inicialmente.

    disabled

    boolean

    • false (default)

    • true

    Se true previne que os usuários interajam com o campo de seleção.

    error

    boolean

    • false (default)

    • true

    Se true adiciona o estilo de erro no campo de seleção.

    fullWidth

    SelectFullWidth

    • false (default)

    • true

    • always

    • sm-up

    • sm-down

    • md-up

    • md-down

    • lg-up

    • lg-down

    • xl-up

    • xl-down

    • xxl-up

    • xxl-down

    Se true ou always o campo de seleção ocupa todo o espaço disponível. Use por breakpoint quando você quiser controlar quando o campo deve ocupar todo o espaço, por exemplo:sm-up ou sm-down para o campo de seleção ocupar todo o espaço disponível apenas quando a tela tem um tamanho menor ou maior que sm.

    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

    • false (default)

    • true

    Se true seu valor deve ser preenchido para submeter o formulário.

    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

    • false (default)

    • true

    Se true previne que os usuários interajam com o campo de seleção.
    Torna a opção indisponível para seleção.

    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.