Pular para o conteúdo
Formulário

Textarea

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

Com rótulo

Aparece na etiqueta do pedido.

Com contador e altura que cresce

Até 300 caracteres.

Nos três tamanhos

Importar
import { Textarea } from '@rivocode/ui'

Quando usar

Campo de várias linhas. Passa pelo Field.Control da Base UI como o Input, então rótulo, ajuda e erro se ligam sozinhos dentro de um Field.

Altura aqui é número de linhas: rows diz quantas o campo mostra antes de rolar. O size (sm, md padrão e lg) é o mesmo do Input e não mexe nas linhas: muda o recuo lateral, o corpo do texto e a altura mínima, que é a de dois campos do mesmo tamanho. Serve para a observação caber no mesmo formulário que um Input size="sm" sem destoar dele.

<Field>
  <FieldLabel>Observação</FieldLabel>
  <Textarea size="sm" rows={3} />
</Field>

Contador de caracteres

Com maxLength, o campo mostra embaixo quanto já foi escrito (120/500) e não aceita passar do limite. O leitor de tela ouve o limite ao entrar no campo ("Até 500 caracteres."), e o que resta só perto do fim, quando faltam 10% ou dez caracteres, o que for maior, e só depois de uma pausa de um segundo na digitação: "Restam 8 caracteres.". Anunciar a cada tecla atropelaria a própria voz de quem digita. showCount={false} deixa só o limite, sem contador.

<Field>
  <FieldLabel>Observação do pedido</FieldLabel>
  <Textarea maxLength={500} placeholder="Ex.: Entregar na portaria, das 8h às 18h." />
</Field>

Altura que cresce com o texto

autoResize faz o campo crescer a cada linha, a partir de rows, até maxRows, e daí em diante rolar por dentro. A medida é feita numa cópia fora da tela, e o campo de verdade nunca encolhe no meio da conta: a página não pula enquanto a pessoa escreve, mesmo com o campo no pé da tela. A alça de redimensionar some, porque quem decide a altura passa a ser o texto.

<Textarea autoResize rows={2} maxRows={8} />

Quando não usar

Para o campo onde a pessoa escreve para um assistente, use PromptInput, de @rivocode/ui/ai: Enter envia e Shift+Enter quebra a linha. O Textarea vai junto com o formulário e não envia no Enter.

Texto com formatação (negrito, lista, link) é RichTextEditor, de @rivocode/ui/editor. E a resposta de uma linha (nome, título, e-mail) é Input: caixa grande para pouco texto convida a escrever mais do que se pede. Texto curto com limite apertado (título de 60 caracteres) também é Input com maxLength: o contador existe para quem escreve parágrafo.

No React Native

Traduz: rows é a altura inicial e o campo cresce com o conteúdo, como o autoResize do web, só que sempre: o TextInput de várias linhas da plataforma já cresce sozinho, e não há alça de redimensionar para desligar. maxRows é o teto, com o nome do web. Com maxLength, o contador embaixo e os textos (labels) são os do web; o limite vai na dica do campo, e o que resta é anunciado perto do fim, depois de uma pausa na digitação. O size do web não atravessa: ele só casa o recuo, o corpo do texto e a altura mínima com o Input vizinho, e no nativo o Input também tem uma altura só.

O texto chega por onValueChange, com o mesmo nome do web e do resto dos campos nativos. O onChangeText do TextInput continua valendo e é chamado junto, e é nele que o forText do @rivocode/ui-native/form se apoia, igual para o Input e para o Textarea.

API

PropTipoPadrão
autoResize

O campo cresce com o texto, a partir de `rows`, ate `maxRows`, e dai em diante rola.

booleanfalse
classNames

Classe por parte: `counter` e a linha do contador.

Partial<Record<"counter", string>>sem padrão
defaultValue0.4.0stringnumberreadonly string[]sem padrão
labels

Os textos do contador, para trocar o idioma: `count` e o visivel, `limit` o que o leitor de tela ouve ao entrar e `remaining` o que ele ouve perto do fim.

Partial<TextareaLabels>sem padrão
maxRows

O teto do `autoResize`, em linhas.

numbersem padrão
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)sem padrão
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>>sem padrão
rows0.4.0

Quantas linhas o campo mostra antes de rolar.

number4
showCount

Mostra o contador embaixo do campo quando ha `maxLength`, que e o padrao.

booleantrue
size

O mesmo vocabulario do Input: muda o recuo lateral, o corpo do texto e a altura minima, que e a de dois campos do mesmo tamanho.

ControlSize"md"

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.