Input
Dentro de um Field
Como consta no cartão do CNPJ.
Inválido
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
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
| Prop | Tipo |
|---|---|
defaultValue0.4.0 | stringnumberreadonly string[] |
onValueChange0.4.0Chamado 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.0Troca 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.0 | ControlSize | null |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.