Ir para o conteúdo

Number field

Campo numérico com botões de incremento e decremento.

Navegadores
Chrome 123+Firefox 121+Safari 17.5+
Nível
1
Tamanho compactado
2.45 kB
Limite de layout forçado
0 ms
Limite do axe
0
Compatível com SSR
Sim
Contrato publicado
Ambiente de teste

Experimentar

Number Field

Padrão

API

NumberField.Root

PropTipoPadrãoDescrição
valuenumber—Número atual, tornando o campo controlado.
defaultValuenumber—Número inicial do campo não controlado.
onValueChange(value: number | undefined) => void—Chamado com o número interpretado, ou undefined quando o input está vazio.
minnumber—Menor valor aceito.
maxnumber—Maior valor aceito.
stepnumber1Quantidade adicionada ou removida pelos botões de incremento e decremento.
formatOptionsIntl.NumberFormatOptions—Opções do Intl.NumberFormat usado para exibir o valor.
clampValueOnBlurbooleantrueTraz um valor fora do intervalo de volta aos limites min e max quando o input perde o foco.
disabledbooleanfalseDesabilita o input e os dois botões de incremento e decremento.
readOnlybooleanfalseTorna o valor somente leitura, mantendo o input focável.
requiredbooleanfalseMarca o input como obrigatório para a validação do formulário.
renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

NumberField.Group

PropTipoPadrãoDescrição
childrenReactNode—O input e os botões de incremento e decremento envolvidos pelo grupo.
renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

NumberField.Input

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

NumberField.Increment

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

NumberField.Decrement

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

Teclado

TeclaAção
TabMova o foco para o controle ou para fora dele
Enter / SpaceAtive quando estiver em foco (controles semelhantes a botões)

Acessibilidade

Usa HTML semântico sempre que possível. Inspecione a marcação renderizada no ambiente interativo — ARIA só é adicionado quando os elementos nativos não bastam.

Pontos de integração de estilos

data-uiify-number-fielddata-disabled