Design systems · Passo 2 · 7 min de leitura
Cor, tipografia e espaçamento como tokens
Os fundamentos de um sistema, transformados em tokens: papéis de cor desenhados em pares medidos, uma escala tipográfica em rem que aguenta o zoom, e uma escala de espaçamento com nomes para dentro e para entre. Os valores reais do Harbour e as razões de contraste, e o que documentar junto de cada token.
É nos tokens de fundamento que a acessibilidade se ganha ou se perde, uma vez, para todas as telas. Se
color.text.subtlepassa no contraste sobrecolor.surface.default, toda tela que usa esse par passa. Se não passa, toda tela reprova, e ninguém percebe, porque cada uma "usa o sistema". Então tokens de fundamento não são uma paleta para escolher. São um conjunto de decisões testadas, e o teste faz parte do token.
O que você vai conseguir fazer depois de ler:
- Desenhar tokens de cor como pares e documentar o contraste medido
- Montar uma escala tipográfica como tokens que respeitam o zoom
- Transformar os valores de espaçamento do inventário numa escala com papéis claros
- Saber quais outros fundamentos viram tokens
1. Cor: tokens vêm em pares
| Token semântico | Claro | Escuro | Medido contra | Contraste, claro / escuro |
|---|---|---|---|---|
color. | sand.50 | ink.900 | (o fundo) | – |
color. | ink.900 | sand.50 | surface.default | 15,6 / 15,6 AAA |
color. | ink.600 | sand.300 | surface.default | 6,7 / 9,8 AA |
color. | blue.600 | blue.400 | surface.default, como link | 6,0 / 5,3 AA |
color. | sand.50 | ink.900 | action.primary, como texto do botão | 6,0 / 5,3 AA |
color. | coral.600 | coral.400 | surface.default | 4,9 / 5,5 AA |
| Erro a evitar | blue.600 | blue.600 mantido | surface.default | 6,0 / 2,6 reprova |
font.size.300 | 1rem (16 px) | igual | texto corrido | – |
space. | space.4 (16 px) | igual; compacto: space.3 (12 px) | espaço interno dos cards | – |
Uma cor sozinha não tem contraste. O contraste pertence a um par: texto sobre uma superfície, um rótulo sobre um botão. Por isso o Harbour desenha os tokens semânticos de cor como pares e mede cada par em cada modo antes de publicar.
Os números da figura foram calculados com a fórmula de luminância relativa da WCAG. As metas: 4,5 para 1 para texto normal, 3 para 1 para texto grande (W3C, Understanding 1.4.3), e 3 para 1 para as partes dos controles e os indicadores de foco que as pessoas precisam enxergar (W3C, Understanding 1.4.11). Para este último, o Harbour tem color.border.focus, apontando para os mesmos azuis de color.action.primary: 6,0 para 1 na superfície clara, 5,3 para 1 na escura.
Olhe a linha do "erro". color.blue.600 sobre a superfície escura do Harbour dá 2,6 para 1. É por isso que color.action.primary aponta para um azul mais claro no modo escuro, e é por isso que a próxima lição existe. Se você fez o curso de UX Foundations, Cor e contraste explica as razões em si.
Documente cada par junto do token: "use sobre surface.default; 6,0:1 no claro, 5,3:1 no escuro". Assim quem usa o token sabe onde ele é seguro.
2. Tipografia: uma escala em rem
Os tokens de tipografia também vêm em dois níveis.
Os primitivos são a própria escala. Os tamanhos de fonte do Harbour, montados sobre os 16 px de texto corrido que o inventário encontrou:
| Token | rem | px no padrão |
|---|---|---|
font.size.100 |
0.75rem | 12 |
font.size.200 |
0.875rem | 14 |
font.size.300 |
1rem | 16 |
font.size.400 |
1.25rem | 20 |
font.size.500 |
1.5rem | 24 |
font.size.600 |
2rem | 32 |
Mais as alturas de linha (font.line-height.tight = 1.2, font.line-height.normal = 1.5), os pesos (font.weight.regular = 400, font.weight.semibold = 600) e a família.
Em rem, não em px, para que o texto siga o tamanho que a pessoa definiu no navegador. A WCAG pede que o texto possa ser ampliado até 200% sem perder conteúdo nem função (W3C, Understanding 1.4.4), e que nada quebre quando a pessoa aumenta a altura de linha para 1,5 vez o tamanho da fonte (W3C, Understanding 1.4.12).
Os tokens semânticos de tipografia juntam tudo isso em estilos com uma função: font.body.md (tamanho 300, altura de linha normal, regular), font.heading.lg (tamanho 600, tight, semibold), font.label.sm (tamanho 200, normal, semibold). O formato DTCG tem um tipo composto typography exatamente para isso (DTCG, Format Module 2025.10). Os componentes usam font.label.sm, nunca "14 px semibold". Para montar a escala em si, veja Monte uma escala tipográfica e Tipografia para interfaces.
3. Espaçamento: uma escala com papéis
space.14 pxspace.28 pxspace.312 pxspace.416 pxspace.524 pxspace.632 pxspace.748 pxspace.864 px
O inventário encontrou vinte e três valores de espaçamento, incluindo 13, 15 e 18 px. O Harbour mantém oito, sobre uma base de 4 px. Os degraus crescem conforme ficam maiores, porque a diferença entre 4 e 8 px é fácil de ver, e a diferença entre 48 e 52, não.
Depois, os tokens semânticos dão papéis à escala:
- Inset: espaço dentro de um contêiner.
space.inset.sm → space.2,space.inset.md → space.4,space.inset.lg → space.5. - Stack: espaço vertical entre itens.
space.stack.sm → space.2,space.stack.md → space.4,space.stack.lg → space.6. - Inline: espaço horizontal entre itens numa linha.
space.inline.sm → space.2,space.inline.md → space.3.
São os papéis que tornam a densidade possível: o modo compacto do console muda space.inset.md de space.4 para space.3 e deixa a escala em paz. Layout, grids e espaçamento mostra como uma escala de espaçamento se encaixa num grid.
4. Os outros fundamentos
O mesmo método vale para toda decisão visual que se repete:
- Raio:
radius.sm = 4px,radius.md = 8px; semânticoradius.control → radius.md. - Espessura de borda:
border.width.default = 1px,border.width.focus = 2px. - Elevação: algumas sombras com nome,
elevation.raised,elevation.overlay, em vez de uma sombra nova por componente. - Movimento: durações e easings como tokens. Isso é uma lição inteira no curso de movimento: Tokens de movimento.
- Breakpoints e tamanhos: área mínima de toque, larguras de contêiner.
Comece pelos que tiveram mais variação no seu inventário. Para a Tidewater: os azuis, o espaçamento, depois o raio.
5. Erros comuns
- Publicar um token de cor sem o par e sem o contraste medido.
- Tamanhos de fonte em px, que as configurações de tamanho do navegador não alcançam.
- Uma escala de espaçamento sem papéis, e as pessoas escolhem "algo que parece certo" entre oito números.
- Alturas de linha fixas em cada componente em vez de tokens compartilhados.
- Transformar tudo em token de uma vez, até valores usados num lugar só.
6. Vocabulário
| Termo | Significado |
|---|---|
| Par de cores | Um token de primeiro plano e o fundo sobre o qual ele foi testado |
| Escala tipográfica | O conjunto fixo de tamanhos de fonte que um sistema permite |
| rem | Uma unidade do CSS relativa ao tamanho de fonte da raiz, que segue as configurações da pessoa |
| Token composto | Um token formado por vários valores, como um estilo de tipografia |
| Inset, stack, inline | Espaço dentro de um contêiner, entre itens na vertical, entre itens numa linha |
| Densidade | O quanto um layout é apertado, como confortável ou compacto |
7. Experimente (sem ferramentas)
- Pegue uma tela que você conhece e liste cada cor de texto dela e o fundo em que cada uma está.
- Escreva cada par como dois nomes de token, como
color.text.subtlesobrecolor.surface.default. - Se puder, confira um par num verificador de contraste. Se não, marque o par que você conferiria primeiro.
Perguntas para refletir: Qual par reprovaria primeiro no modo escuro? Quais valores de espaçamento da tela não têm um papel claro?
8. Se você já pratica
- Gere a tabela de contraste a partir dos tokens, em todos os modos, e faça o build falhar quando um par documentado cair abaixo da meta.
- Escreva "use sobre" para cada cor semântica, e o contrário, "nunca sobre", onde as pessoas costumam errar.
- Teste a escala tipográfica com 200% de zoom no navegador e com altura de linha de 1,5 na sua tela mais densa.
Checklist
Para saber mais
- W3C: Understanding 1.4.3, Contrast (minimum) · 1.4.11, Non-text contrast · 1.4.4, Resize text · 1.4.12, Text spacing
- Design Tokens Community Group: Format Module 2025.10, tipos · Color Module 2025.10
- IBM Carbon: Color tokens
Livros, cursos e vídeos para ir mais fundo
- Design SystemsAlla KholmatovaLivro · Smashing Media, 2017 (Amazon)
- Atomic DesignBrad Frost2016, grátis na internet (Amazon)
Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.
Relacionadas
Níveis de tokens · Temas e modos · Cor e contraste · Monte uma escala tipográfica · Tipografia para interfaces · Layout, grids e espaçamento · Tokens de movimento · Componentes acessíveis