Vibe Design Tips

CSS para textos que misturam chinês e inglês

007 Type Switches

CSS para textos que misturam chinês e inglês

Tipografia e layout

Como resolver, em textos em chinês e inglês, as quebras de linha dos títulos, os números que tremem, o texto truncado, os detalhes do chinês e o tamanho das traduções.

Na primeira tela de um site, a segunda linha do título fica com uma palavra só; numa contagem regressiva, o texto ao lado se mexe a cada salto; ao trocar para o alemão, o rótulo de um botão é espremido em duas linhas. São problemas de quebra de linha e de largura dos caracteres, e a maioria se resolve com algumas regras de CSS. Os casos mais comuns são estes:

  1. Quebras de linha: títulos usam text-wrap: balance, para que as linhas tenham tamanho parecido e a última não fique com uma ou duas palavras; o texto corrido usa text-wrap: pretty, para não sobrar uma palavra sozinha no fim do parágrafo; rótulos de botão usam white-space: nowrap e ficam sempre em uma linha.
  2. Números: em números que mudam, como cronômetros, preços e contadores, font-variant-numeric: tabular-nums dá a mesma largura a todos os algarismos. Sem isso, ao passar de 11 para 10, o “1” é mais estreito que o “0” e o texto seguinte se desloca.
  3. Truncamento: para mostrar reticências num texto longo, além de text-overflow: ellipsis é preciso pôr min-width: 0 no elemento dentro do layout flexível. A largura mínima de um filho flex é, por padrão, a largura do conteúdo; sem essa regra, o texto alarga o contêiner e as reticências não aparecem.
  4. Texto em chinês: text-align: justify justifica o texto, e com a largura da linha igual a um número inteiro de caracteres a margem direita fica alinhada; text-autospace: normal põe automaticamente um espaço entre o chinês e o texto latino ou os números; text-spacing-trim: trim-start remove o meio espaço em branco de um parêntese de abertura no início da linha.
  5. Títulos em chinês e regras de início e fim de linha: nos títulos, o BudouX marca os pontos de quebra entre palavras e, junto com word-break: keep-all, o texto quebra por palavras, nunca no meio de uma. As regras de início e fim de linha ficam por conta do navegador, e remove-se line-break: anywhere, que as desativa.
  6. Vários idiomas: o mesmo espaço precisa acomodar traduções de tamanhos diferentes; as palavras em alemão costumam ser mais longas que em inglês, e um botão que em inglês cabe exatamente em uma linha pode não caber em alemão. Ao traduzir, peça ao agente que leve em conta o layout da página e escolha uma tradução de tamanho adequado, sem quebrar uma palavra em duas linhas nem deixar espaço vazio demais.

O prompt que acompanha esta dica escreve essas regras nos estilos globais, herdados por todas as páginas, e só ajusta a quebra de linha, o espaçamento, o alinhamento e o truncamento do texto, sem mudar os textos, as fontes nem as cores; no fim, lista os arquivos alterados e compara o antes e o depois nas suas páginas.

PromptCole em um agent como Claude Code ou Cursor
Polish the typography in my product with a set of CSS switches. Change only how text wraps, spaces, aligns and truncates. No copy, font, colour or layout changes beyond what each rule says.

0. Start from what exists
- Put the rules in the global text styles (base CSS, typography tokens, Tailwind config or shared text components) so every page inherits them. Add per-component rules only where a component overrides the base.
- Every rule below is progressive enhancement: browsers that don't know a property ignore it. Add no polyfills.
- Scope the Chinese rules with :lang(zh), and make sure the lang attribute is set on the html element or on the element itself, so English text keeps its own rules.

1. Headings break into even lines
- On h1 to h3, card titles and hero lines: text-wrap: balance;
- Lines come out about the same length, so a heading never ends on one lonely word. Short text only: Chrome balances up to 6 lines.

2. No lone word at the end of a paragraph
- On paragraphs, descriptions and list items: text-wrap: pretty;
- Also join pairs that must not split with a non-breaking space (U+00A0): an em dash and the name after it, a number and its unit.

3. Numbers that change keep their width
- On anything that updates in place or sits in a column (counters, prices, timers, stats, table cells): font-variant-numeric: tabular-nums;
- The font must have tabular figures (the tnum feature); check that the width actually stops changing. Leave running text proportional.

4. Button labels stay on one line
- On buttons and other labels in flex rows: white-space: nowrap; (flex-shrink: 0 works too)
- A crowded row must not squeeze a label onto two lines.

5. Long text truncates instead of spilling out
- A flex item won't shrink below its content, so text inside it can't truncate. On the flex item: min-width: 0;
- On the text itself: overflow: hidden; white-space: nowrap; text-overflow: ellipsis;
- When the text really is cut (scrollWidth > clientWidth), show the full text in a tooltip on hover.

6. Chinese body text: justified, on a whole number of characters
- On Chinese paragraphs only: text-align: justify;
- Set the measure to a whole number of characters (for example max-width: 26em at the paragraph's font size), so a justified line only stretches to absorb Latin words and squeezed punctuation.
- Not for narrow columns (under about 15 characters), short text, captions, buttons or mostly-English text: the gaps get uneven.

7. Space between Chinese and Latin text or numbers
- On Chinese text: text-autospace: normal;
- The browser adds a thin gap between Han characters and Latin letters or digits. Don't also hand-type spaces in copy or translation files. Skip code, inputs and monospaced text.

8. No half-width gap before an opening bracket at a line start
- On Chinese UI text without a first-line indent: text-spacing-trim: trim-start;
- An opening 「 “ ( at the start of a line drops its blank half and lines up with the text above. Long-form text with a two-character indent should use space-first instead. Chrome only for now.

9. Chinese headings break between words
- Chinese has no spaces, so a heading can split a word across lines. Mark the break points between words with BudouX (its Simplified or Traditional Chinese model), inserting a wbr element at each one, at build time for static copy or at render time for dynamic copy. Then: word-break: keep-all; overflow-wrap: anywhere; text-wrap: balance;
- Never use keep-all on Chinese without break points: the heading becomes one unbreakable word. Don't use Intl.Segmenter for this (it splits common words wrongly), and don't apply it to body text.

10. Line-start and line-end rules (避头尾)
- Browsers already keep punctuation off the start of a line and squeeze line-end punctuation. Don't rebuild this.
- Find and remove any line-break: anywhere used to stop overflow: it turns these rules off. Use overflow-wrap: anywhere instead.
- Text drawn on canvas or SVG, or wrapped by hand in JS, gets none of this: apply the rules there yourself.

11. When done
- List every file and selector you changed.
- List every line-break: anywhere and word-break: break-all you removed or kept, and why.
- Show before and after on my own pages: a wrapped heading, a paragraph ending, a changing number, a truncated label and a mixed Chinese-English paragraph.