Pular para o conteúdo
Formulário

Input

/componentes/input.mdmarkdown cru, para quem lê com agent em vez de olho

Dentro de um Field

Como consta no cartão do CNPJ.

Inválido

Falta o domínio depois do @, como em nome@empresa.com.br.

Desabilitado e somente leitura

Gerado no cadastro, e não muda.

Veio da transportadora: dá para copiar, e não para editar.

Nos três tamanhos

Com prefixo e sufixo, pelo InputGroup

https://
.rivocode.com.br
Importar
import { Input } from '@rivocode/ui'

Quando usar

Controle de texto. Vive dentro de Field.

size: sm, md (padrão) e lg, todos lendo a altura do token de densidade. O atributo size nativo do HTML não existe aqui de propósito, porque colidiria com a variante.

Desabilitado e somente leitura não têm a cara do controle vivo. O desabilitado troca borda, fundo e texto (border-disabled, surface-raised, fg-disabled), o mesmo trio do Button. O readOnly mantém o texto legível e copiável, e troca a borda contínua por tracejada sobre surface-raised: o valor veio de outro lugar e não se edita aqui. A borda tracejada se vê nos dois temas, inclusive no claro, onde surface-raised é o mesmo branco de surface. Textarea, o gatilho do Select e a moldura do InputGroup vestem os mesmos dois estados.

Quando não usar

Para dado com forma conhecida, a peça certa já existe: dinheiro é CurrencyInput; CPF, CNPJ, telefone e placa são MaskedInput; data é DatePicker; hora é TimeField; quantidade com passo é NumberField; e senha é PasswordInput. Cada uma traz o teclado, o molde e a conferência que um Input com o type trocado não dá.

Texto que passa de uma linha, como observação ou descrição, é Textarea. E o campo que só filtra a lista da tela é SearchInput, com a lupa e o Esc que limpa. E-mail e chave Pix continuam aqui, sem máscara.

No React Native

Traduz: o @rivocode/ui-native exporta Input - a borda acende no foco: não há focus-visible em tela de toque; onValueChange recebe o texto, como no web, e o onChangeText do TextInput continua valendo. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.

O campo sai igual no iOS e no Android: a mesma altura, o texto centrado na linha, e o cursor, as alças e a seleção no accent do tema, e não no azul de um sistema e no verde do outro. selectionColor e cursorColor continuam valendo para quem quer outra cor. No iOS, o campo de uma linha deixa de lado a altura de linha do text-base, que empurrava o texto para baixo do centro; um lineHeight no style ainda vence.

Todo campo do pacote tem a moldura do Input: a mesma altura vazia (h-12) e o texto na mesma coluna (px-3.5 dentro da borda), do MaskedInput ao TagsInput e aos gatilhos que abrem folha, como o Select e o DatePicker. Com adorno na frente - a lupa do SearchInput, o R$ do CurrencyInput, o prefixo do InputGroup - é o adorno que abre na coluna, e o texto vem depois dele.

O teclado é do sistema: forma, cor e sugestões mudam entre iOS e Android, e no Android mudam também com o teclado instalado. A peça escolhe só o tipo (números, telefone, e-mail), pelo keyboardType.

API

PropTipo
defaultValue0.4.0stringnumberreadonly string[]
onValueChange0.4.0

Chamado quando o `value` muda.

((value: string, eventDetails: { reason: "none"; event: Event; cancel: () => void; allowPropagation: () => void; isCanceled: boolean; isPropagationAllowed: boolean; trigger: Element | undefined; }) => void)
render0.4.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, FieldControlState> | ReactElement<unknown, string | JSXElementConstructor<any>>
size0.4.0ControlSize | null

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.