Textarea
Com rótulo
Aparece na etiqueta do pedido.
Com contador e altura que cresce
Nos três tamanhos
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
| Prop | Tipo | Padrão |
|---|---|---|
autoResizeO campo cresce com o texto, a partir de `rows`, ate `maxRows`, e dai em diante rola. | boolean | false |
classNamesClasse por parte: `counter` e a linha do contador. | Partial<Record<"counter", string>> | sem padrão |
defaultValue0.4.0 | stringnumberreadonly string[] | sem padrão |
labelsOs 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 |
maxRowsO teto do `autoResize`, em linhas. | number | sem padrão |
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) | sem padrão |
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>> | sem padrão |
rows0.4.0Quantas linhas o campo mostra antes de rolar. | number | 4 |
showCountMostra o contador embaixo do campo quando ha `maxLength`, que e o padrao. | boolean | true |
sizeO 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.