Ir para o conteúdo

Select

Componente que envolve o elemento select nativo.

Navegadores
Chrome 135+Firefox 121+
Por que esta versão?

Firefox keeps the native select control. This custom styling uses ::picker(select), :open, and option::checkmark, which Firefox does not support yet.

Safari 17+
Por que esta versão?

Safari keeps the native select control. This custom styling uses ::picker(select), :open, and option::checkmark, which Safari does not support yet.

Nível
0
Tamanho compactado
480 B
Limite de layout forçado
0 ms
Limite do axe
0
Compatível com SSR
Sim
Contrato publicado
Ambiente de teste

Experimentar

Select

Padrão

Agrupado

Animal de estimação

Com separadores

Valor longo

API

Select.Root

PropTipoPadrãoDescrição
childrenReactNode—Partes de Select, normalmente um Select.Content com itens e grupos.
valuestring—Valor selecionado, tornando o select controlado.
defaultValuestring—Valor selecionado na primeira renderização; a partir daí, o select nativo gerencia a seleção, permitindo o funcionamento sem JavaScript.
onValueChange(value: string) => void—Chamado com o novo valor quando a seleção muda.
namestring—Nome do campo de formulário enviado com o valor selecionado.
disabledbooleanfalseDesabilita o select nativo e define o atributo data-disabled.
renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

Select.Content

PropTipoPadrãoDescrição
childrenReactNode—Itens, grupos e separadores; a parte renderiza seus filhos sem adicionar um elemento.

Select.Item

PropTipoPadrãoDescrição
childrenReactNode—Texto exibido para esta opção.
disabledbooleanfalseImpede a seleção desta opção.
value*string—Valor enviado quando esta opção é selecionada.
renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

Select.Group

PropTipoPadrãoDescrição
childrenReactNode—Itens que pertencem a este grupo.
label*string—Título do grupo exibido pelo agrupamento nativo de opções.
renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

Select.Separator

PropTipoPadrãoDescrição
renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

Teclado

TeclaAção
Arrow keysAltere a opção quando estiver em foco
SpaceAbra o seletor nativo (plataforma)

Acessibilidade

<select> nativo apenas de texto; o navegador controla seleção, entrada por teclado, busca por digitação e envio do formulário. Navegadores compatíveis aprimoram apenas a aparência do seletor.

Pontos de integração de estilos

data-disabled
Esta página foi traduzida automaticamente e ainda não foi revisada.