Pular para o conteúdo
Tipografia

Heading

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

Os tamanhos que acompanham o nível

Turmas

Abertas em agosto

Inglês intermediário

Alunos matriculados
Observações

Nível e tamanho separados

Resumo do mês

O título é o segundo da página, e por isso é um h2. Aqui ele mora dentro de uma coluna estreita, e por isso é pequeno.

Título que não cabe

Introdução à programação para iniciantes, turma da noite

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

Quando usar

O título de uma seção, com o nível e o tamanho separados. level decide a tag, de h1 a h6, e é o que o leitor de tela usa para saltar de seção em seção; size decide o corpo na escala da casa, de sm a 3xl.

<Heading level={2}>Turmas</Heading>
<Heading level={2} size="md">Resumo do mês</Heading>

A separação existe para a ordem dos títulos não ficar refém do tamanho. Quando a tag carrega o desenho, quem quer um título menor desce o nível, e a página passa a pular de h2 para h4 sem ter um h3. Quem navega por título ouve um buraco que não está na tela. Aqui o tamanho muda sozinho, e o nível continua dizendo onde o título mora.

level não tem padrão, de propósito: quem sabe o nível é a página, e não a peça. Sem size, o corpo acompanha o nível: h1 é 2xl, h2 é xl, h3 é lg, h4 é md, h5 é base e h6 é sm. A letra é a font-display em peso 600, a mesma do CardTitle e do PageHeader.

truncate corta em uma linha com reticências, para o título que mora numa coluna estreita. A frase inteira continua no DOM, e o leitor de tela lê tudo.

Quando não usar

  • Topo de rota: PageHeader. Ele já traz o h1, a trilha, a descrição e as ações, na mesma hierarquia em todas as páginas; montar isso com Heading é reescrever o topo a cada rota.
  • Título de cartão, diálogo ou folha: CardTitle, DialogTitle, SheetTitle. Eles ligam o título à região que nomeiam (o DialogTitle vira o nome acessível do diálogo), e um Heading solto ali não liga nada.
  • Texto que só precisa parecer grande: Text com size="lg" e weight="semibold". Título é para o que abre uma seção; um número de destaque ou uma frase de efeito que não abre nada não entra no esboço da página.

No React Native

Traduz, com os mesmos level, size e truncate do web, e o mesmo tamanho para cada nível quando size não vem. Sai como Text com accessibilityRole="header", na família display do provider.

O nível não é anunciado. O VoiceOver e o TalkBack dizem “cabeçalho” e param aí: não há h1 a h6 no toque. O level continua obrigatório mesmo assim, por dois motivos: ele decide o tamanho quando size não vem, e a tela porta do web sem reescrever a chamada.

size="display" existe só aqui. É o título de abertura de tela, 32px: o piso do clamp() do text-display do web, que é o que ele desenha numa tela de telefone. O gerador de tokens lê o piso do tema, e o nativo anda junto quando ele muda.

API

PropTipo
levelobrigatória

O lugar do titulo no esboco da pagina, de 1 a 6: decide a tag, de `h1` a `h6`, e e o que o leitor de tela usa para saltar de secao em secao.

HeadingLevel
refRef<HTMLHeadingElement>
size

O corpo na escala da casa, de `sm` (13px) a `3xl` (30px).

HeadingSize
truncate

Corta em uma linha com reticencias, para titulo dentro de coluna estreita.

boolean

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.