Funções de cor
Há 26 funções de cor padrão organizadas em seis grupos: primária, secundária, terciária, erro, superfície e contorno.
O que são funções de cor?
As funções de cor são como os “números” em uma pintura numerada. Elas são o elo entre os elementos da interface e o local onde cada cor é aplicada.
- As funções de cor são mapeadas para os componentes do Material
Use essas funções de cor independentemente de você optar pelo esquema estático baseline ou pela cor dinâmica. Se o seu produto contiver componentes personalizados, eles também precisarão ser mapeados corretamente para esse conjunto de funções de cor. - As funções de cor garantem acessibilidade
O sistema de cores é construído com base em combinações de cores acessíveis. Esses pares de cores garantem um contraste mínimo de 3:1 para fins de acessibilidade. - As funções de cor são tokenizadas
As funções são implementadas no design e no código por meio de tokens. Um token de design representa uma decisão pequena e reutilizável que faz parte do estilo visual de um sistema de design.

Conceitos gerais
Aqui estão alguns termos úteis que você verá nos nomes das funções de cor:
- Superfície – Uma função usada para planos de fundo e áreas grandes e de baixa ênfase da tela.
- Primária, secundária, terciária – Funções de cor de destaque usadas para enfatizar ou reduzir a ênfase de elementos em primeiro plano.
- Contêiner – Funções usadas como cor de preenchimento para elementos em primeiro plano, como botões. Essas funções não devem ser usadas para texto ou ícones.
- Sobre – Funções que começam com este termo indicam uma cor para texto ou ícones aplicados sobre a cor à qual estão associados. Por exemplo, sobre primária é usada para texto e ícones sobre a cor de preenchimento primária.
- Variante – Funções que terminam com este termo oferecem uma alternativa de menor ênfase em relação à função correspondente sem esse sufixo. Por exemplo, variante de contorno é uma versão menos enfatizada da cor contorno.
Combinação e sobreposição de cores
Para garantir contraste visual acessível no seu app, aplique as cores apenas aos pares e às ordens de camadas previstos nas seções a seguir.
Combinar cores de forma inadequada pode comprometer o contraste necessário para a acessibilidade visual, especialmente quando as cores são ajustadas por recursos de cor dinâmica, como o contraste controlado pelo usuário.


Funções de cor de destaque
As funções de cor de destaque incluem primária, secundária e terciária. Atribua-as a elementos da interface com base na importância e na ênfase necessária. Tenha cuidado ao alterar funções de cor para criar efeitos visuais.
- Funções primárias são para ações importantes e elementos que precisam da maior ênfase, como um FAB para iniciar uma nova mensagem.
- Funções secundárias são para elementos que não exigem atenção imediata nem ênfase, como o estado selecionado de um ícone de navegação ou um botão de dispensa.
- Funções terciárias são para elementos menores que precisam de ênfase especial, mas não exigem atenção imediata, como um badge ou uma notificação.

- As cores primárias são usadas para os elementos mais importantes, como uma mensagem marcada com estrela e um FAB para iniciar uma nova mensagem
- As cores terciárias são usadas para elementos menores enfatizados, como um badge que sugere um acompanhamento
- As cores secundárias são usadas para elementos menos urgentes, como o plano de fundo de um ícone de estrela inativo e o estado selecionado de um ícone de caixa de entrada
Primária
Use funções primárias para os componentes mais proeminentes da interface, como o FAB, botões de alta ênfase e estados ativos.
- Primária: Preenchimentos, textos e ícones de alta ênfase sobre a superfície
- Sobre primária: Texto e ícones sobre a primária
- Contêiner primário: Cor de preenchimento de destaque sobre a superfície, para componentes importantes como o FAB
- Sobre contêiner primário: Texto e ícones sobre o contêiner primário


- Sobre primária
- Primária

- Sobre contêiner primário
- Contêiner primário
Secundária
Use funções secundárias para componentes menos proeminentes da interface, como chips de filtro.
Há quatro funções secundárias:
- Secundária: Preenchimentos, texto e ícones menos proeminentes sobre a superfície
- Sobre secundária: Texto e ícones sobre a secundária
- Contêiner secundário: Cor de preenchimento menos proeminente sobre a superfície, para componentes discretos como botões tonais
- Sobre contêiner secundário: Texto e ícones sobre o contêiner secundário


- Ícone: Sobre contêiner secundário
- Botão: Contêiner secundário
Terciária
Use funções terciárias para destaques contrastantes que equilibram as cores primária e secundária ou chamam mais atenção para um elemento, como um campo de entrada.
Há quatro funções terciárias:
- Terciária: Preenchimentos, texto e ícones complementares sobre a superfície
- Sobre terciária: Texto e ícones sobre a terciária
- Contêiner terciário: Cor de contêiner complementar sobre a superfície, para componentes como campos de entrada
- Sobre contêiner terciário: Texto e ícones sobre o contêiner terciário

As funções de cor terciárias podem ser aplicadas a critério do designer. Elas têm como objetivo ampliar a expressividade das cores.

- Sobre contêiner terciário
- Contêiner terciário
Erro
Use funções de erro para comunicar estados de erro, como uma senha incorreta inserida em um campo de texto.
Há quatro funções de erro:
- Erro: Cor que chama a atenção sobre a superfície para preenchimentos, ícones e texto, indicando urgência
- Sobre erro: Texto e ícones sobre o erro
- Contêiner de erro: Cor de preenchimento que chama a atenção sobre a superfície
- Sobre contêiner de erro: Texto e ícones sobre o contêiner de erro
A cor de erro é um exemplo de cor estática: ela não muda mesmo em esquemas de cor dinâmica. Por padrão, as funções de cor de erro são definidas como estáticas em qualquer esquema de cor dinâmica, mas ainda se adaptam aos temas claro e escuro.

Superfície
Use funções de superfície para planos de fundo mais neutros e funções de contêiner de superfície para componentes como cartões, painéis (sheets) e diálogos.
Há três funções de superfície:
- Superfície: Cor padrão para planos de fundo
- Sobre superfície: Texto e ícones sobre qualquer cor de superfície ou de contêiner de superfície
- Sobre variante de superfície: Cor de menor ênfase para texto e ícones sobre qualquer cor de superfície ou de contêiner de superfície

Há também cinco funções de contêiner de superfície nomeadas com base em seus níveis de ênfase:
- Contêiner de superfície de ênfase mínima: Contêiner com o menor nível de ênfase
- Contêiner de superfície de baixa ênfase: Contêiner com baixo nível de ênfase
- Contêiner de superfície: Contêiner com nível de ênfase padrão
- Contêiner de superfície de alta ênfase: Contêiner com alto nível de ênfase
- Contêiner de superfície de ênfase máxima: Contêiner com o maior nível de ênfase
Contêiner de superfície é a função padrão, mas as outras são especialmente úteis para criar hierarquia e contêineres aninhados em layouts para telas expandidas.
A combinação mais comum de funções de superfície usa superfície para uma área de plano de fundo e contêiner de superfície para uma área de navegação.
Texto e ícones normalmente usam sobre superfície e sobre variante de superfície em todos os tipos de superfície.

- Superfície
- Contêiner de superfície
Todos os mapeamentos de cor – mas especialmente as cores de superfície – devem permanecer os mesmos para as regiões de layout em todos os breakpoints. Por exemplo, a área de conteúdo usará a cor superfície e a área de navegação usará a cor contêiner de superfície tanto no celular quanto no tablet.

- Superfície
- Contêiner de superfície
Dependendo da hierarquia necessária, da área funcional e da lógica de design, você pode usar cores de superfície adicionais em classes de tamanho de janela maiores, desde que as cores sejam aplicadas de forma consistente.
Por padrão, componentes com cores neutras, como barras de navegação, menus ou diálogos, são mapeados para funções específicas de contêiner de superfície, mas essas funções podem ser remapeadas por designers e desenvolvedores para atender às necessidades dos usuários.

Funções padrão de contêiner de superfície aplicadas a componentes:
- Contêiner de superfície de baixa ênfase
- Contêiner de superfície
- Contêiner de superfície de alta ênfase
- Contêiner de superfície de ênfase máxima
Cores inversas
As funções inversas são aplicadas seletivamente a componentes para produzir cores inversas às da interface ao redor, criando um efeito contrastante.
- Superfície inversa: Preenchimentos de plano de fundo para elementos que contrastam com a superfície
- Sobre superfície inversa: Texto e ícones sobre a superfície inversa
- Primária inversa: Elementos acionáveis, como botões de texto, sobre a superfície inversa


Um snackbar que usa:
- Superfície inversa para o plano de fundo
- Sobre superfície inversa para o texto
- Primária inversa para o botão de texto
Contorno
Há duas funções de contorno para uso sobre uma superfície:
- Contorno: Limites importantes, como a borda de um campo de texto
- Variante de contorno: Elementos decorativos, como divisores, e situações em que outros elementos já fornecem contraste de 4,5:1


- Um campo de texto que usa contorno para a borda do contêiner
- Um item de lista que usa variante de contorno para o divisor




Funções de cor adicionais
A maioria dos produtos não precisará usar essas funções de cor adicionais. No entanto, alguns produtos exigem a flexibilidade e o controle adicionais que essas funções oferecem. Se você não tiver certeza se o seu produto deve usá-las, provavelmente não precisa e pode ignorá-las.
Cores de destaque fixas
Primária fixa, secundária fixa, e terciária fixa são cores de preenchimento usadas sobre a superfície. Essas cores mantêm o mesmo tom nos temas claro e escuro, ao contrário das cores de contêiner comuns, que mudam de tom entre esses temas. A função de cor fixa pode ser usada em vez da função de contêiner equivalente quando esse comportamento fixo é desejado.
As funções primária fixa dim, secundária fixa dim e terciária fixa dim fornecem um tom mais escuro e com mais ênfase em relação à cor fixa equivalente. Elas podem ser usadas quando se deseja uma cor mais profunda, mas com o mesmo comportamento fixo.




Exemplos de cores fixas e fixas dim em uso:
- Primária fixa para a cor de contêiner de um FAB
- Primária fixa dim para o contêiner de um botão de ícone


Cores “Sobre” para destaques fixos
As cores “Sobre” fixas são usadas para texto e ícones que ficam sobre a cor fixa correspondente. Por exemplo, sobre primária fixa é usada para texto e ícones sobre a cor primária fixa. O mesmo uso se aplica às cores secundárias e terciárias equivalentes.
As cores “Sobre” variante fixa são usadas para texto e ícones que precisam de menor ênfase sobre a cor fixa correspondente. Por exemplo, sobre variante de primária fixa é usada para texto e ícones de menor ênfase sobre a cor primária fixa. O mesmo uso se aplica às cores secundárias e terciárias equivalentes.


Funções de superfície Surface bright e Surface dim
Há duas funções de superfície adicionais:
- Surface dim: Cor de superfície mais escura nos temas claro e escuro
- Surface bright: Cor de superfície mais clara nos temas claro e escuro


Embora a função superfície padrão se inverta automaticamente entre os temas claro e escuro (ela é clara no tema claro e escura no tema escuro), as funções Surface bright e Surface dim não seguem exatamente essa inversão: elas mantêm seu brilho relativo nos dois temas.
Por exemplo, em uma interface que usa a função superfície padrão, a área mapeada é a mais clara no tema claro e a mais escura no tema escuro. Em uma interface que usa a função Surface bright, a área mapeada é a mais clara tanto no tema claro quanto no tema escuro.

- Superfície
- Contêiner de superfície

- Superfície
- Contêiner de superfície

- Surface bright
- Contêiner de superfície

- Surface bright
- Contêiner de superfície

- Trilho de navegação com plano de fundo Surface dim
- Janela de chat com plano de fundo Surface bright