Ótima tipografia
Boa tipografia é, acima de tudo, moderação. Uma escala sensata, espaçamento confortável e contraste suficiente superam qualquer efeito engenhoso. Um rótulo, uma célula de tabela, um título de marketing e um parágrafo de artigo não devem compartilhar um conjunto único de regras. Aplique estes princípios ao construir ou revisar qualquer coisa que contenha texto.
Ao revisar, leia a página em vez de escanear o código: aperte os olhos para verificar se a hierarquia se sustenta, leia um parágrafo inteiro para verificar o conforto e redimensione a viewport para capturar quebras ruins, viúvas e truncamento em comprimentos de conteúdo reais.
As palavras em si (rótulos de botão, mensagens de erro, estados vazios) são cobertas pelo skill better-writing; a estrutura semântica de cabeçalhos pelo better-accessibility; o layout espacial RTL e as propriedades CSS lógicas pelo better-layout; a medição de contraste de pares renderizados e a remediação de cor pelo better-colors. Este skill é responsável por como o texto é renderizado, quebrado e se comporta em conteúdo de direção mista.
Use o sistema de estilo do projeto. Antes de sugerir ou escrever qualquer correção, verifique como o codebase estiliza as coisas e expresse cada mudança nesse sistema: utilitários Tailwind em um projeto Tailwind, declarações simples em CSS, CSS Modules, styled-components ou StyleX. A folha de dicas mapeia cada declaração para seu equivalente no Tailwind. Nunca introduza uma segunda abordagem de estilo apenas para aplicar uma correção de tipografia.
Referência Rápida
| Categoria | Quando usar | Referência |
|---|---|---|
| Escolhendo fontes | Categorias de fonte, combinação, formatos, anatomia do tipo | escolhendo-fontes.md |
| Fontes variáveis e OpenType | Eixos, pesos, números tabulares, conjuntos estilísticos | fontes-variaveis-e-opentype.md |
| Espaçamento e dimensionamento | Escala tipográfica, hierarquia de cabeçalhos, line-height, letter-spacing, ajuste de texto | espacamento-e-dimensionamento.md |
| Quebra e pontuação | Medida, quebra de linha, truncamento, pontuação inteligente, RTL | quebra-e-pontuacao.md |
| Detalhes e acessibilidade | Sublinhados, seleção, formulários, texto decorativo, contraste | detalhes-e-acessibilidade.md |
| Folha de dicas CSS | Consulta rápida de cada propriedade coberta, com equivalentes Tailwind | css-cheat-sheet.md |
Princípios Fundamentais
1. Sirva o Formato Correto
Use .woff2 (compressão Brotli, amplamente suportado) na web. .woff é um fallback apenas para navegadores muito antigos; .ttf e .otf são formatos de desktop brutos sem compressão web. Como os arquivos são carregados é preocupação do próprio projeto, este skill não o prescreve.
2. Propriedades Acima de Tags Raw
Quando uma propriedade CSS existe, use-a. font-weight: 650 em vez de font-variation-settings: "wght" 650, font-optical-sizing: auto em vez de "opsz", font-variant-numeric: tabular-nums em vez de font-feature-settings: "tnum" 1. As propriedades continuam funcionando quando um fallback não variável é renderizado. Reserve as tags raw para eixos personalizados ("GRAD" 80) e recursos de nicho ("ss01" 1) que não têm propriedade própria.
3. Carregue Pesos e Estilos Intencionais
Os navegadores podem sintetizar um peso ou estilo solicitado que a família ativa não fornece. Prefira carregar as faces que o design realmente usa. Defina font-synthesis: none somente após verificar que cada forma necessária (negrito, itálico, versaletes, sobrescrito e subscrito) permanece visualmente distinta em toda a pilha de fallback completa; desabilitar a síntese não é um diagnóstico e não deve apagar a ênfase.
4. Menos Fontes, Tamanhos e Pesos
Raramente use mais de três fontes. Peso e tamanho definem hierarquia, mas o uso excessivo prejudica rapidamente a legibilidade. Combine por contraste, não por similaridade: um título com serifa com um corpo sem serifa parece intencional, dois sem serifa quase idênticos parecem um erro. Abaixo de 18px, fique no peso 400+; pesos abaixo de 300 são apenas para exibição (28px+), eles desaparecem em tamanhos de texto.
5. Use uma Escala Tipográfica com Nomes Semânticos
Defina um pequeno conjunto de tamanhos e desvie-se dele o mínimo possível. Tamanhos codificados manualmente sem um sistema quebram em escala. Para projetos individuais, nomes padrão como text-sm funcionam bem, desde que as regras de uso sejam claras. Em uma equipe, nomeie os tamanhos pelo uso (text-corpo-sm), não pelo tamanho, para que as regras permaneçam consistentes.
6. Tamanhos de Cabeçalho Diminuem com o Nível
Dentro de uma hierarquia de página coerente, mapeie os níveis de cabeçalho para etapas decrescentes da escala tipográfica: um cabeçalho visualmente subordinado não deve acidentalmente sobrepujar seu pai. Níveis adjacentes podem compartilhar um tamanho na extremidade inferior da escala, desde que o peso ou o espaçamento os mantenham distintos. Escolha elementos de cabeçalho semânticos de acordo com better-accessibility; este skill controla apenas seu tratamento visual.
7. Line-Height por Função
Cabeçalhos mais apertados, por volta de 1.1. Corpo de texto 1.5 a 1.6. Prefira valores sem unidade para que o line-height dimensione com o tamanho da fonte; valores fixos como 24px não. Line-height apertado é para texto curto: qualquer coisa que quebre em três ou mais linhas precisa de pelo menos 1.4, mesmo em linhas com altura restrita.
8. Letter-Spacing por Tamanho
Cabeçalhos grandes geralmente ficam melhores com letter-spacing ligeiramente negativo. Rótulos pequenos em maiúsculas precisam de um pouco de letter-spacing positivo para que as letras não pareçam apertadas. Corpo de texto em tamanhos de leitura não precisa de nenhum.
9. Limite a Medida
Linhas longas dificultam que o olho encontre a próxima linha. Limite o texto longo a cerca de 60–75 caracteres por linha. Qualquer unidade funciona: 65ch mede caracteres diretamente, e um limite em pixels ou rem é igualmente bom: em um tamanho de corpo de 16px, o intervalo fica aproximadamente entre 560px e 680px dependendo da fonte, então max-w-xl ou max-w-2xl do Tailwind se encaixam. O que importa é que um limite exista e o comprimento de linha resultante esteja dentro do intervalo.
10. Quebra Intencional
text-wrap: balance distribui o texto uniformemente entre as linhas: use-o em cabeçalhos. text-wrap: pretty evita deixar uma única palavra curta na linha final: use-o em descrições. Pule ambos em texto longo: os navegadores ignoram balance após algumas linhas de qualquer maneira, e uniformizar um parágrafo inteiro desperdiça espaço e dificulta a leitura. overflow-wrap: break-word onde palavras longas, links ou IDs podem escapar do contêiner. white-space: nowrap em rótulos e badges onde uma quebra de linha parece quebrada.
11. Números Tabulares em Valores Variáveis
Os dígitos têm larguras diferentes por padrão, então temporizadores, contadores e preços mudam de layout à medida que são atualizados. Aplique font-variant-numeric: tabular-nums a qualquer valor que mude.
12. Trunque Sem Perder Conteúdo
Única linha: text-overflow: ellipsis com overflow: hidden e white-space: nowrap. Múltiplas linhas: line-clamp. O truncamento esconde conteúdo, portanto, se o texto ausente for importante, mantenha o valor completo acessível em uma tooltip ou visualização expandida.
13. Escreva o Texto Naturalmente, Estilize com CSS
Armazene o texto em caixa natural e controle a apresentação com text-transform, para que redesigns nunca exijam reescrever o texto. Use pontuação inteligente: aspas curvas em prosa (aspas retas em código), um travessão en dash para intervalos como 2010–2020, um travessão em dash para destacar um pensamento, o caractere de reticências único, para manter valores como 16 px juntos e ­ para controlar onde palavras longas podem quebrar.
14. Sublinhados da Fonte
Os sublinhados padrão ficam onde o navegador decide. Extraia posição e espessura das métricas da própria fonte com text-underline-position: from-font e text-decoration-thickness: from-font, ou ajuste manualmente com text-decoration-thickness, text-underline-offset e text-decoration-skip-ink. text-decoration-style desenha a linha pontilhada, tracejada ou ondulada; um sublinhado pontilhado é uma dica comum de que uma palavra carrega informações extras, como uma abreviação ou um termo definido. A menos que a única coisa animando seja uma mudança de cor, construa o sublinhado como um elemento separado em vez de usar text-decoration: a cor é a única parte de um sublinhado real que anima de forma confiável.
15. Inputs a 16px no Mobile
O Safari no iOS aumenta o zoom de toda a página quando o texto de um input é menor que 16px. Duas correções mantêm o tamanho da fonte em 16px de maneiras diferentes, portanto, pergunte qual delas o design deseja em vez de escolher silenciosamente: dimensione o input para cima no mobile (text-base sm:text-sm), o que muda sua aparência em telas pequenas, ou mantenha font-size: 16px e renderize o tamanho pretendido com transform: scale(), compensando a largura e o line-height para que o design seja idêntico em cada viewport. Ambas as receitas.
16. Pisos de Tamanho e Contraste
Comece o texto do corpo longo próximo ao padrão do navegador de 16px, depois julgue-o no tipo de letra real, medida, plataforma e densidade do produto. O texto da IU pode ser menor: 14px é um ponto de partida útil para inputs e menus (inputs ainda precisam de 16px no mobile, veja o princípio 15), 13px para legendas, raramente abaixo de 12px. Quando o texto aparecer com baixo contraste, use better-colors para medir o par renderizado e better-accessibility para classificar o requisito; não altere as cores a menos que seja solicitado.
17. Suavização de Fonte na Raiz
No macOS, o texto é renderizado mais pesado do que o pretendido. Aplique -webkit-font-smoothing: antialiased e -moz-osx-font-smoothing: grayscale (ambos cobertos pelo antialiased do Tailwind) uma vez no layout raiz para que cubram todo o texto.
18. Comportamento de Idioma e Bidirecional
Defina lang para que navegadores e tecnologia assistiva escolham a pronúncia, citações e hifenização corretas. Defina dir no documento ou limite de conteúdo onde a direção muda, preserve a ordem dos dígitos e use <bdi> para valores isolados de direção mista quando necessário. O espelhamento espacial e as propriedades CSS lógicas pertencem a better-layout.
19. Mantenha o Texto Útil Selecionável
::selection pode trazer a marca para a experiência de leitura quando a combinação selecionada permanece legível. Mantenha o texto selecionável por padrão. Use user-select: none apenas em uma superfície específica arrastável ou orientada a gestos onde a seleção acidental interfira comprovadamente na interação; nunca desabilite a seleção em toda a interface ou meramente porque um rótulo de botão pode ser destacado.
Erros Comuns
| Erro | Correção |
|---|---|
.ttf/.otf servidos na web | Converter para .woff2 |
font-variation-settings: "wght" para peso | font-weight (funciona com fallbacks não variáveis) |
font-feature-settings: "tnum" 1 | font-variant-numeric: tabular-nums |
| Face sintetizada difere do design pretendido | Carregue a face necessária; desabilite apenas o modo de síntese verificado sem apagar a ênfase |
| Tamanhos de fonte codificados e únicos | Use a escala tipográfica |
| Cabeçalho filho visualmente sobrepuja seu pai | Mapeie a hierarquia dessa seção para etapas decrescentes da escala |
| Elemento de cabeçalho escolhido por seu tamanho padrão | Escolha a semântica com better-accessibility, depois defina o tamanho visual em CSS |
line-height: 24px em texto escalável | Valor sem unidade (1.5) |
| Parágrafos em largura total | Limite a cerca de 60–75 caracteres por linha |
| Órfão na última linha de um parágrafo | text-wrap: pretty |
| Cabeçalho de duas linhas desequilibrado | text-wrap: balance |
| Números causam mudança de layout | tabular-nums |
| Texto truncado sem como lê-lo | Tooltip ou visualização expandida para o valor completo |
MAIÚSCULAS digitadas no texto | Caixa natural + text-transform |
| Texto justificado em uma interface | text-align: start; reserve justificado para layouts editoriais específicos |
| Sublinhado corta descendentes | text-decoration-skip-ink: auto, métricas from-font |
Inputs abaixo de 16px dão zoom no iOS | Pergunte primeiro: text-base sm:text-sm, ou 16px reduzido com transform para manter o tamanho projetado |
| Layout raiz omite suavização de fonte | Aplique antialiased uma vez na raiz |
| Valor de direção mista renderiza na ordem errada | Defina lang/dir corretos; isole o valor com <bdi> quando necessário |
| Seleção desabilitada em todo o chrome da aplicação | Restaure a seleção; suprima-a apenas em uma interação específica que conflita com arrastar ou gestos |
| Dica de informação extra sem dica visual | Sublinhado pontilhado via text-decoration-style: dotted |
Peso Fino/Claro em texto de IU de 14px | Peso 400+ abaixo de 18px; pesos finos são apenas para exibição |
leading-none em uma descrição de card de três linhas | Pelo menos 1.4 em qualquer texto que quebre em 3+ linhas |
Formato de Saída da Revisão
Use este formato apenas quando o usuário solicitar uma revisão de tipografia independente. Quando better-interface orquestrar a revisão, forneça evidências e descobertas de domínio para esse skill e deixe que seu formato de saída, escala de gravidade, regras de consolidação, limite e veredito tenham precedência.
Apresente a revisão independente em duas partes.
Descobertas
Agrupe todas as descobertas confirmadas por princípio. Use uma tabela markdown com as colunas Gravidade, Localização, Antes, Depois e Porquê. Nunca use linhas separadas "Antes:" / "Depois:".
- Gravidade:
ALTAtorna o texto ilegível, indisponível ou estruturalmente enganoso;MÉDIAprejudica hierarquia, quebra ou varredura;BAIXAé um polimento tipográfico isolado. - Localização: cite
caminho/para/arquivo:linha. Se o artefato não tiver arquivos de origem, cite a tela e o componente exatos. - Antes / Depois: mostre a tipografia atual e uma substituição acionável.
- Porquê: nomeie o princípio violado e seu efeito na legibilidade ou hierarquia.
Consolide um problema sistêmico repetido em uma linha e liste todos os locais afetados. Omita princípios sem descobertas.
Exemplo
Números tabulares
| Gravidade | Localização | Antes | Depois | Porquê |
|---|---|---|---|---|
| MÉDIA | src/Price.tsx:17 | <span>{price}</span> em um preço ao vivo | <span className="tabular-nums">{price}</span> | Dígitos proporcionais fazem valores variáveis mudarem |
| BAIXA | src/numbers.css:8 | font-feature-settings: "tnum" 1 | font-variant-numeric: tabular-nums | A propriedade de alto nível preserva o comportamento de fallback |
Line-height e medida
| Gravidade | Localização | Antes | Depois | Porquê |
|---|---|---|---|---|
| MÉDIA | src/Article.tsx:33 | leading-none em um parágrafo do corpo | leading-normal (1.5) |
…
[truncado para tradução]