Pular para o conteúdo

Cores

Todas as cores são CSS Custom Properties (--mds-colors-*), nunca hex fixo no HTML/CSS de consumo. Cada papel semântico tem 5 tons (lighter, light, main, dark, darker) + seu par de contraste — nomenclatura alinhada ao Figma (--mds-colors-<papel>-<tom> para o fundo, --mds-colors-<papel>-on-<tom> para o texto/ícone legível sobre ele, ex.: --mds-colors-primary-main + --mds-colors-primary-on-main).

As paletas do sistema com os valores reais dos tokens, nos temas claro, escuro e dark blue. Escolha uma paleta para ver a escala completa (50 a 900) e a matriz de contraste entre fundos e textos, em APCA ou WCAG 2, no tamanho e peso de texto que você vai usar.

Tema
Contraste

Paletas do sistema

Os cinco tons que cada paleta expõe como token, com o texto que o sistema usa sobre eles (on-*): o claro ou o escuro,o que tiver o maior contraste APCA. O número ao lado é o contraste desse par. Clique numa paleta para ver a escala completa e a matriz.

Escala

Matriz de acessibilidade

Cada linha é um fundo e cada coluna, uma cor de texto. As duas primeiras linhas são as superfícies do tema (card e página); as duas primeiras colunas, os textos claro e escuro da paleta. Em cada fundo, ★ marca o texto de maior contraste APCA: é ele que vira o on-* do tom. Clique numa célula para ver o par aplicado.

Prévia do par

Quer testar uma cor que ainda não está no sistema? Use o Gerador de cores. Para entender de onde vêm os valores (a fórmula da escala, como o par on-<tom> é escolhido e o build), veja Geração de Cores.

Papel Token base lighter light main dark darker Quando usar
Primary --mds-colors-primary-* #ecf3ff #a0c4fd #408afa #3068bb #20457d Ação principal, marca, item ativo/selecionado, foco de interação
Secondary --mds-colors-secondary-* #e9ebf3 #939ac5 #27348b #1d2768 #141a46 Marca institucional, badges/destaques secundários, campo válido (borda)
Danger --mds-colors-danger-* #fcebe6 #f29980 #e53200 #ac2600 #731900 Erro, exclusão, bloqueio, ação irreversível
Warning --mds-colors-warning-* #fef9e6 #f8e280 #f0c400 #b49300 #786200 Atenção, campo obrigatório, dado pendente de revisão
Info --mds-colors-info-* #e6f3fb #80c3ed #0087db #0065a4 #00446e Mensagem neutra, dica, estado informativo sem urgência
Success --mds-colors-success-* #e6f9e6 #80e381 #00c703 #009502 #006402 Confirmação, conclusão, dado validado

on-<tom> é a cor de texto/ícone garantida legível sobre aquele fundo — sempre use o par (--mds-colors-<papel>-main + --mds-colors-<papel>-on-main), nunca aplique texto escuro fixo sobre um fundo de token.

Os fundos de todas as famílias de cor batem com o Figma Design System 2.0. Histórico das conferências e das correções: docs/historico-cores-e-temas.md (material de manutenção).

Escala base: --mds-colors-gray-0 #fefefe … --mds-colors-gray-50 #fafbfc … --mds-colors-gray-100 #f3f4f6 … --mds-colors-gray-200 #e8eaee … --mds-colors-gray-300 #dcdfe5 … --mds-colors-gray-400 #d0d4dc … --mds-colors-gray-500 #9c9fa5 … --mds-colors-gray-600 #686a6e … --mds-colors-gray-700 #343537 … --mds-colors-gray-800 #151516 … --mds-colors-gray-900 #060607.

Uso Token Valor Regra
Surface / Card --mds-dimmed-default #fefefe Fundo padrão de card, modal, painel — “branco” do sistema
Background (página) --mds-colors-background-light #fafbfc Fundo da aplicação por trás dos cards
Background (elemento) --mds-colors-background-main #f3f4f6 Fundo de blocos secundários (ex.: .mds-box)
Background (rebaixado) --mds-colors-background-dark #e8eaee Hover neutro, divisores de área, estado “dimmed”
Border --mds-colors-border-main #e8eaee Toda borda 1px de card, input, tabela
Text — corpo (padrão) --mds-colors-foreground-main #686a6e Texto de parágrafo, valor de dado, corpo em geral
Text — ênfase/secundário --mds-colors-foreground-dark #343537 Título, rótulo em destaque, texto que precisa de mais peso que o corpo
Text — muted/apoio --mds-colors-foreground-light #9c9fa5 Placeholder, texto de ajuda, timestamp, metadado de baixa prioridade

Note a inversão de intuição: foreground-dark é o texto de MAIOR ênfase (mais escuro = mais peso), e foreground-light é o texto de MENOR ênfase (mais claro = apoio). Siga essa semântica, não o nome literal.

Não existe token destructive isolado — Danger cobre esse papel (botão de exclusão = variant="danger" / .mds-btn--danger, --mds-colors-border-error = #e53200).

  • --mds-colors-background-shadow: rgba(22, 22, 23, 0.15) — base de toda sombra do sistema.
  • --mds-colors-background-transparency: rgba(52, 53, 55, 0.6) — backdrop de modal/drawer.
Tenant Cor main
brand-mobiis #408afa
blue #0087db
teal #00dbdb
aqua #00f0b8
green #00c703
yellow #f0c400
orange #f07800
red #e53200
pink #ff0073

[data-theme="dark"] e :root aplicam-se ao mesmo elemento — uma prop não redeclarada em [data-theme="dark"] cai para o valor de :root (cascata normal do CSS); a maioria dos papéis redeclara os 5 tons com valores próprios para dark. Ex.: primary-main é #408afa no claro e #3068bb no escuro. Neutros do tema escuro: fundo #121c2b, texto de corpo #d1d8e2. Um agente de IA nunca deve ler valor de cor fixo: sempre referenciar o token, para funcionar nos dois temas automaticamente.

  • Três temas, todos sobre os mesmos tokens: claro (padrão), [data-theme="dark"] e [data-theme="dark-blue"] (neutros azul-marinho). Qualquer tema combina com [data-primary="..."].
  • No escuro a sombra quase não aparece: a hierarquia vem da luminosidade da superfície (página background-light < bloco rebaixado background-main < card dimmed-default < hover/borda). Use o token de fundo da camada certa em vez de depender de box-shadow para separar planos.
  • Não presuma que -dark/-darker escurecem: no tema escuro esses tons clareiam. Não monte hover ou ênfase próprios com esses tons; use os estados que o componente já tem ou os tokens semânticos (foreground-*, border-*, ui-interactive-*).
  • Contraste já está resolvido nos pares de token (texto de corpo, apoio, erro, link, borda de campo) nos três temas. Texto colorido usa --mds-colors-foreground-{primary|secondary|error|warning|info|success}, não o main do papel (note: o de perigo é foreground-error).