Tokens de design: Visão geral
Tokens de design são os blocos de construção de todos os elementos da interface do usuário. Os mesmos tokens são usados em designs, ferramentas e no código.
- Os tokens apontam para valores de estilo como cores, fontes e medidas
- Use tokens de design em vez de valores fixos no código
- Cada token é nomeado de acordo com o modo ou o local em que é usado (por exemplo, md.comp.fab.primary.container.color define a cor do contêiner de um FAB)
- Mesmo que o valor final de um token mude, seu nome e uso permanecem os mesmos
- O Material Design tem três classes de tokens: referência, sistema e componente

Recursos
| Tipo | Link | Status |
|---|---|---|
| Design | Design Kit (Figma) | Disponível |
| Material Theme Builder Figma plugin | Disponível | |
| Implementação | Tema base e tokens do Material (DSP) | Disponível |
O que é um token de design?
Tokens de design são decisões de design pequenas e reutilizáveis que compõem o estilo visual de um sistema de design. Os tokens substituem valores estáticos por nomes autoexplicativos.
Um token de design consiste em duas coisas:
- Um nome em formato de código, como md.ref.palette.secondary90
- Um valor associado, como #E8DEF8
O valor de um token pode ser uma cor, uma fonte, uma medida ou até outro token.

Os tokens de design conectam de forma significativa escolhas de estilo que, de outra forma, não teriam uma relação clara.
Por exemplo, se o protótipo de um designer e a implementação de um desenvolvedor usarem o mesmo token para a “cor do contêiner secondary”, ambos podem ter certeza de que a mesma cor está sendo usada nos dois lugares. Isso se aplica mesmo que o valor hexadecimal atribuído a esse token seja atualizado.

Por que os tokens são importantes?
Os tokens permitem que um sistema de design tenha uma fonte única da verdade – um repositório onde as escolhas de estilo são registradas e as alterações podem ser rastreadas.
Como os tokens são reutilizáveis e têm um propósito definido, eles podem definir atualizações de tema e de contexto em todo o sistema. Por exemplo, você pode usar tokens para aplicar sistematicamente uma paleta de cores de alto contraste para melhorar a visibilidade, ou alterar a escala tipográfica para garantir que o texto seja legível em uma tela de TV.
Ao usar tokens para design e implementação, as atualizações de estilo se propagam de forma consistente por todo um produto ou conjunto de produtos. Os tokens também ajudam designers e desenvolvedores a “falar a mesma língua”, reduzindo a confusão na transição do design para a implementação.

Como decidir se os tokens são adequados para você
Os tokens serão mais úteis se:
- Você planeja atualizar o design do seu produto ou está criando um produto do zero
- Seu sistema de design é aplicado a um conjunto de produtos ou plataformas
- Você deseja facilitar a manutenção ou a atualização de estilos no futuro
- Você deseja aproveitar ao máximo o sistema Material Design, incluindo recursos como cor dinâmica
Os tokens serão menos úteis se:
- Você tem um aplicativo existente que usa valores fixos no código e provavelmente não passará por mudanças nos próximos um ou dois anos
- Seu produto não tem um sistema de design
Tokens e Material Design
No passado, os estilos do Material eram comunicados por meio de diretrizes, arquivos de design, ferramentas e bibliotecas de componentes específicas de cada plataforma.
Com os tokens de design, agora você pode baixar, personalizar e aplicar os estilos do Material e integrá-los ao seu processo de design e desenvolvimento.
Os tokens permitem documentar decisões em um formato independente de plataforma e compartilhável.

Neste site, você verá os tokens listados em módulos interativos.
Esses módulos permitem consultar rapidamente o valor base padrão armazenado nos tokens para cor, fonte, tamanho da fonte, peso da fonte, etc. Eles também mostram a relação entre um papel, seu token de sistema, seu token de referência e o valor predefinido armazenado.

Você também verá tokens nas abas de especificações dos artigos sobre componentes.
Os tokens são agrupados primeiro por estado (habilitado, desabilitado, hover, etc.) e depois por elemento, que é a parte do componente à qual um token ou valor se aplica, como o contêiner ou o texto do rótulo.
As colunas incluem:
- Nome – O aspecto de estilo do componente ao qual o token se aplica, como cor ou fonte
- ID do token – O token que define o aspecto de estilo do componente
- Descrição – Informações descritivas opcionais
- Contexto/valor – O valor armazenado no token para um determinado contexto

Como usar os módulos de tokens
Digamos que você precise verificar a função de cor do texto do rótulo de um botão preenchido.
Navegue até Botões comuns > Especificações, encontre o módulo de tokens dos botões preenchidos e procure os tokens de “texto do rótulo” na seção de elementos.
Copie o token de cor e cole-o no código, ou compare-o com a função de cor no Figma.

Partes de um nome de token
As partes de um nome de token são separadas por pontos (.) e vão da informação mais geral (“md”) à mais específica (“on-secondary”).
- Todos os nomes de tokens em um sistema de design começam com o nome do sistema (como “md” para Material Design)
- Uma abreviação para a classe do token: “ref” para tokens de referência, “sys” para tokens de sistema e “comp” para tokens de componente
- O nome termina com palavras descritivas que indicam o papel do token

- Comunica o sistema de design
- Comunica a classe do token
- Comunica o propósito do token
Classes de tokens
Há três classes de tokens no Material:
- Tokens de referência
Todos os tokens disponíveis com valores associados. - Tokens de sistema
Decisões e papéis que dão ao sistema de design seu caráter, da cor e da tipografia à elevação e à forma. - Tokens de componente
As propriedades de design atribuídas a elementos em um componente, como a cor do ícone de um botão.
Com três classes de tokens, as equipes podem atualizar decisões de design globalmente ou aplicar uma alteração a um único componente.

Tokens de referência
Esses tokens compõem todas as opções de estilo disponíveis em um sistema de design.
Eles geralmente apontam para um valor estático – como um código de cor hexadecimal ou um tamanho de fonte – mas também podem apontar para outros tokens de referência. Os tokens de referência não mudam com base no contexto.
Ao fornecer uma lista de opções, os tokens de referência oferecem à sua equipe um ponto de partida com cores, tipografia, medidas etc. aprovadas.
Todos os tokens de referência começam com o prefixo ref.

Tokens de sistema
Esses tokens são as decisões que sistematizam a linguagem de design de um tema ou contexto específico.
Os tokens de sistema definem o propósito que um token de referência cumpre na interface do usuário.
É aqui que a aplicação de temas acontece. O token de sistema pode apontar para diferentes tokens de referência dependendo do contexto, como um tema claro ou escuro.
Sempre que possível, os tokens de sistema devem apontar para tokens de referência em vez de valores estáticos.
Todos os tokens de sistema começam com o prefixo sys.

Tokens de componente (em desenvolvimento)
Esses tokens representam os elementos necessários para compor um componente, como contêineres, texto do rótulo, ícones, estados e seus valores, como tamanho, forma, cor ou elevação.
Sempre que possível, os tokens de componente devem apontar para um token de sistema ou de referência, em vez de conter valores fixos no código, como códigos hexadecimais.
Nem toda escolha estilística de um componente pode ser representada por um token, mas sempre que uma escolha de design se aplicar a vários componentes com intenção semelhante, um token deve ser usado.
Todos os tokens de componente começam com o prefixo comp.

Contextos
Os tokens podem apontar para valores diferentes dependendo de um conjunto de condições. Essas condições são chamadas de contextos, e os valores resultantes são chamados de valores contextuais.
Exemplos de diferentes contextos incluem: formatos de dispositivo, tema escuro, layouts densos e sistemas de escrita da direita para a esquerda.
Você pode pensar em um contexto como um tipo de etiqueta. Se um valor de token estiver marcado com o tema escuro, ele substituirá o valor padrão do token em um contexto de tema escuro.
