Marcus Andrey Estudo
Read in English Biblioteca

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.subtle passa no contraste sobre color.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ânticoClaroEscuroMedido contraContraste, claro / escuro
color.surface.default sand.50 ink.900(o fundo)–
color.text.default ink.900 sand.50surface.default15,6 / 15,6 AAA
color.text.subtle ink.600 sand.300surface.default6,7 / 9,8 AA
color.action.primary blue.600 blue.400surface.default, como link6,0 / 5,3 AA
color.text.on-action sand.50 ink.900action.primary, como texto do botão6,0 / 5,3 AA
color.feedback.danger coral.600 coral.400surface.default4,9 / 5,5 AA
Erro a evitar blue.600 blue.600 mantidosurface.default6,0 / 2,6 reprova
font.size.3001rem (16 px)igualtexto corrido–
space.inset.mdspace.4 (16 px)igual; compacto: space.3 (12 px)espaço interno dos cards–
Os tokens de fundamento do Harbour, com o contraste medido. Cada par de cores foi conferido nos dois modos antes de o token ser publicado, e os números ficam na documentação do token. A linha do "erro" mostra o que acontece se o modo escuro mantiver o azul do claro: 2,6 para 1, bem abaixo dos 4,5 para 1 que a WCAG pede para texto.Razões calculadas com a fórmula de luminância relativa da WCAG 2.2. Tabela: Marcus Andrey, CC BY 4.0.

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

  1. space.14 px
  2. space.28 px
  3. space.312 px
  4. space.416 px
  5. space.524 px
  6. space.632 px
  7. space.748 px
  8. space.864 px
A escala de espaçamento do Harbour: oito passos sobre uma base de 4 px, crescendo mais rápido conforme ficam maiores. Os vinte e três valores de espaçamento encontrados no inventário viraram estes oito. Passos pequenos separam coisas dentro de um componente; passos grandes separam seções.Diagrama: Marcus Andrey, CC BY 4.0.

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ântico radius.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)

  1. Pegue uma tela que você conhece e liste cada cor de texto dela e o fundo em que cada uma está.
  2. Escreva cada par como dois nomes de token, como color.text.subtle sobre color.surface.default.
  3. 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

Livros, cursos e vídeos para ir mais fundo

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

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar