Pular para o conteúdo
Formulário

InputGroup

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

Encostos

.com.br
kg
Importar
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

PropTipoPadrão
size0.5.0

A 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.md

Botã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.md

O 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.md

O encosto depois do campo, dentro do InputGroup.

Sem prop própria: repassa ao elemento de baixo o que você mandar.

@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.