Pular para o conteúdo
Tipografia

Text

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

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.

Importar
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; um Text com font-mono parece 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; Text em 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

PropTipo
lineClamp

Corta depois de tantas linhas, de 1 a 6, com reticencias na ultima.

123456
refRef<HTMLParagraphElement>
render

Troca 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>>
size

O corpo na escala da casa, de `xs` (12px) a `lg` (18px); acima disso e titulo, e o titulo e o `Heading`.

TextSize
tone

O 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
truncate

Corta em uma linha com reticencias.

boolean
weight

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

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