Text
Os tons
Texto corrido, no tom neutro.
Texto secundário, que explica o de cima.
Legenda, atualizada há 2 minutos.
Pagamento aprovado.
Assinatura vence em 5 dias.
Pagamento recusado.
Nova versão do aplicativo disponível.
Trecho dentro da frase
O total do mês foi R$ 48.310,00, e o trecho herda o corpo da frase.
Cortar o que não cabe
Recusado pela transportadora por divergência no CEP informado no pedido, e devolvido ao estoque depois de duas tentativas de entrega no mesmo dia.
Recusado pela transportadora por divergência no CEP informado no pedido, e devolvido ao estoque depois de duas tentativas de entrega no mesmo dia.
import { Text } from '@rivocode/ui'Quando usar
Parágrafo ou trecho de texto, vestido com os papéis da casa: size na escala
de xs a lg, tone entre os papéis de texto do tema, e weight.
<Text size="sm" tone="muted">Atualizado há 2 minutos.</Text>
Sai num <p>. O render troca o elemento sem mudar o desenho:
render={<span />} para o trecho dentro de uma frase, render={<div />} para
o bloco que contém outro bloco, que um <p> não pode conter.
Sem size, sem tone e sem weight, o texto herda de quem o cerca. É o
que faz o trecho funcionar: um valor em negrito dentro de uma frase sm fica
sm, e fica da cor da frase se não pedir outra. O custo é que o parágrafo
solto também herda, e o corpo da página é o do seu app; passe size no
parágrafo de fora.
Os tons são os papéis de texto do tema, e só eles: neutral é o texto
corrido, muted o secundário, subtle a legenda, accent o destaque da
marca, e success, warning, danger e info são os -text de cada
estado, os que se leem sobre o fundo da página. Os de preenchimento
(bg-danger e parentes) não entram, porque não têm contraste como texto.
truncate corta em uma linha, e lineClamp corta depois de 1 a 6 linhas;
quando os dois vêm, lineClamp vence. O texto cortado continua inteiro no
DOM: o leitor de tela ouve tudo, e quem vê precisa de um title ou de um
Tooltip para ler o resto.
Quando não usar
- Nome de arquivo, comando ou chave de JSON no meio da frase:
Code. Ele muda a letra para a de largura fixa e marca o trecho como código; umTextcomfont-monoparece igual e não diz o que é. - Uma tecla ou um atalho:
Kbd. Ele desenha a tecla e diz o nome dela a quem ouve a tela;Textem negrito escrito "Ctrl+K" não faz nenhuma das duas coisas. - Título de seção:
Heading. Texto grande não entra no esboço da página, e quem navega por título não o encontra. - Rótulo de campo:
FieldLabel, que se liga ao controle.
No React Native
Traduz, e o Text nativo é o mesmo primitivo que as outras peças do pacote já vestem, agora com size, tone, weight, truncate e lineClamp, os mesmos nomes e os mesmos valores do web. truncate e lineClamp viram numberOfLines.
Sem as props novas, o aninhado herda, como no web. Um Text dentro de outro Text leva o corpo e a cor do de fora, e é isso que faz o trecho em negrito no meio da frase funcionar. A diferença está no topo: o React Native não herda cor de View, então o Text de fora sem tone sai em text-fg, a cor de texto do tema - a mesma do tone="neutral" -, e não na cor padrão do aparelho, que era preto no tema escuro. A cor que vem em className ou em style vence esse padrão.
Não há render: o elemento do celular é sempre Text, e o bloco é uma View em volta.
API
| Prop | Tipo |
|---|---|
lineClampCorta depois de tantas linhas, de 1 a 6, com reticencias na ultima. | 123456 |
ref | Ref<HTMLParagraphElement> |
renderTroca o elemento mantendo a aparencia: `<Text render={<span />}>` para o trecho dentro de uma frase, `<Text render={<div />}>` para o bloco que contem outro bloco. | ReactElement<unknown, string | JSXElementConstructor<any>> |
sizeO corpo na escala da casa, de `xs` (12px) a `lg` (18px); acima disso e titulo, e o titulo e o `Heading`. | TextSize |
toneO papel de cor: `neutral` e o texto corrido, `muted` o secundario, `subtle` a legenda, e os tons de estado sao os `-text`, os que se leem sobre o fundo da pagina. | TextTone |
truncateCorta em uma linha com reticencias. | boolean |
weightO peso da letra, lido dos tokens de peso do tema: `regular` e `--rc-weight-regular`, `medium` e `--rc-weight-medium`, `semibold` e `--rc-weight-strong` e `bold` e `--rc-weight-bold`. | TextWeight |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.