InputGroup
Encostos
import { InputGroup } from '@rivocode/ui'Quando usar
Moldura que encosta texto ou botão no campo: https:// antes, .com.br ou
kg depois, botão de copiar.
A borda e o anel de foco passam para a moldura, e o campo de dentro entrega os dois. Sem isso aparecem duas bordas encaixadas e dois anéis, e o conjunto deixa de parecer um campo só.
Acompanham InputPrefix, InputSuffix e InputAction.
size (sm, md, lg) muda a altura da moldura e o respiro de dentro: o
espaço lateral do campo e dos encostos segue o tamanho, e a letra dos encostos
também. Passe o mesmo size ao Input, que escolhe a letra do que se digita.
O InputPrefix começa na coluna do texto de todo campo da casa, e o texto
vem logo depois dele, a 8px, sem divisória: R$ 0,00 e a chave do Pix com o
ícone na frente leem como um campo só, alinhados com o Input de cima. O
InputSuffix faz o espelho do lado direito. Só o InputAction, que é botão,
leva a divisória.
<InputGroup size="sm">
<InputPrefix>R$</InputPrefix>
<Input size="sm" aria-label="Valor" />
</InputGroup>
Quando não usar
Para valor em reais que a pessoa digita, use CurrencyInput: o R$ encostado
aqui só desenha a moeda, e o valor continua texto, sem centavos inteiros nem a
digitação da direita.
Busca com lupa e Esc que limpa é SearchInput, e senha com o olho que revela é
PasswordInput. As duas já vêm prontas, e montá-las com InputPrefix e
InputAction desenha o mesmo campo sem o comportamento.
No React Native
Traduz, e a forma muda junto: no web a moldura é composição (InputGroup por fora, Input, InputPrefix e InputAction por dentro) e ela desarma a borda do campo com um seletor de descendente. Esse seletor não existe no React Native, e quem escrevesse a mesma árvore lá ganharia duas bordas encaixadas sem jeito de apagar a de dentro. Por isso a moldura nativa desenha o campo: value, onValueChange, prefix, suffix e actions são props dela. Não há size: altura de controle é única no nativo, porque alvo de toque não encolhe.
As peças de dentro viram partes do classNames, com o nome delas: input, prefix, suffix e action.
API
| Prop | Tipo | Padrão |
|---|---|---|
size0.5.0A altura da moldura e o respiro de dentro, que acompanham o campo: o espaco lateral do campo, do `InputPrefix` e do `InputSuffix` segue o tamanho, e a letra dos encostos tambem. | "lg""md""sm" | "md" |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.
Partes
InputGroup se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.
InputAction
/input-action.mdBotão colado no campo, sem borda própria e ocupando a altura toda. Serve para buscar, copiar, mostrar a senha.
O nome é obrigatório pelo tipo, como o label do IconButton: só de ícone,
ele pede aria-label (ou aria-labelledby); com texto, o nome é o próprio
texto, escrito como string. Diga a ação (“Copiar link”), e não o desenho.
<InputGroup>
<Input aria-label="Link de convite" defaultValue="https://rivocode.com.br/convite/4821" readOnly />
<InputAction aria-label="Copiar link">
<Copy />
</InputAction>
</InputGroup>
Sem prop própria: repassa ao elemento de baixo o que você mandar.
InputPrefix
/input-prefix.mdO encosto antes do campo, dentro do InputGroup. Texto curto, sigla ou ícone.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
InputSuffix
/input-suffix.mdO encosto depois do campo, dentro do InputGroup.
Sem prop própria: repassa ao elemento de baixo o que você mandar.