Tema escuro
Um tema escuro é uma interface do usuário (UI) com pouca iluminação, que exibe principalmente superfícies escuras.

Uso
Um tema escuro exibe superfícies escuras na maior parte da UI. Ele foi projetado como um modo complementar ao tema padrão (ou claro).
Os temas escuros reduzem a luminância emitida pelas telas dos dispositivos e, ao mesmo tempo, atendem às proporções mínimas de contraste de cores. Eles ajudam a melhorar a ergonomia visual: reduzem o cansaço visual, ajustam o brilho às condições de iluminação do ambiente e facilitam o uso da tela em ambientes escuros – tudo isso economizando bateria. Dispositivos com telas OLED se beneficiam da capacidade de desligar os pixels que exibem preto, a qualquer momento.
Princípios

Escurecer com cinza
Use cinza escuro (em vez de preto) para expressar elevação e espaço em ambientes com uma gama mais ampla de níveis de profundidade.

Cor com destaques
Aplique destaques de cor limitados em UIs de tema escuro, para que a maior parte do espaço seja dedicada a superfícies escuras.

Conservar energia
Em produtos que exigem eficiência (como dispositivos com telas OLED), economize bateria reduzindo o uso de pixels que emitem luz.

Aprimorar a acessibilidade
Atenda às necessidades dos usuários habituais de tema escuro, como pessoas com baixa visão, cumprindo os padrões de acessibilidade de contraste de cores.
Propriedades
Os temas escuros do Material Design são definidos pelas seguintes propriedades:
- Contraste: As superfícies escuras e o texto de corpo 100% branco têm uma proporção de contraste de pelo menos 15.8:1
- Profundidade: Em níveis mais altos de elevação, os componentes expressam profundidade exibindo cores de superfície mais claras
- Dessaturação: As cores primárias são dessaturadas para atender ao padrão AA das Diretrizes de Acessibilidade para Conteúdo da Web (WCAG) de pelo menos 4.5:1 (quando usadas com texto de corpo), em todos os níveis de elevação
- Cor limitada: As superfícies grandes usam uma cor de superfície escura, com destaques de cor limitados (cores claras e dessaturadas, ou cores brilhantes e saturadas)
Anatomia
As UIs de tema escuro usam predominantemente superfícies escuras, com poucos destaques de cor. Elas emitem pouca luz, mantendo um alto padrão de usabilidade.

2. Surface (com sobreposição de superfície na elevação de 1dp)
3. Primary
4. Secondary
5. On background
6. On Surface
7. On Primary
8. On Secondary
Comportamento
Um tema escuro pode ser ativado (ou desativado) por meio de um controle exibido:
- De forma proeminente, usando um ícone de alternância para ativar ou desativar o tema
- Com proeminência reduzida, com um botão de alternância colocado dentro de um menu ou das configurações de um app



Propriedades
Um tema escuro usa cinza escuro, em vez de preto, como cor de superfície principal dos componentes. Superfícies cinza-escuras podem expressar uma gama mais ampla de cores, elevação e profundidade, porque as sombras ficam mais visíveis no cinza do que no preto.
Superfícies cinza-escuras também reduzem o cansaço visual, já que o texto claro sobre uma superfície cinza-escura tem menor contraste do que sobre uma superfície preta.

Elevação
Em um tema escuro, os componentes mantêm os mesmos níveis de elevação e as mesmas sombras padrão usadas nos temas claros. No entanto, as superfícies de diferentes níveis de elevação são iluminadas de forma diferente.
Elevação mais alta, superfície mais clara
Quanto mais alta a elevação de uma superfície (aproximando-a de uma fonte de luz implícita), mais clara essa superfície se torna. Esse clareamento é obtido pela aplicação de uma sobreposição semitransparente com a cor On Surface.
Uma superfície de tema escuro é criada pela aplicação de uma sobreposição semitransparente sobre a cor de superfície de um componente.

1. Surface
2. Sobreposição de elevação
A sobreposição em uma superfície também facilita distinguir a elevação entre os componentes e ver as sombras. As sobreposições adicionam contraste entre as superfícies e suas sombras, tornando as bordas de cada superfície mais evidentes.
Esses valores de sobreposição de superfície foram projetados para maximizar a legibilidade e, ao mesmo tempo, garantir que os diferentes níveis de elevação sejam distinguíveis entre si.

| Nível de elevação | Transparência da sobreposição branca |
|---|---|
| 00dp | 0% |
| 01dp | 5% |
| 02dp | 7% |
| 03dp | 8% |
| 04dp | 9% |
| 06dp | 11% |
| 08dp | 12% |
| 12dp | 14% |
| 16dp | 15% |
| 24dp | 16% |
As sobreposições evidenciam a diferença de elevação entre os componentes.

B. Um botão de ação flutuante com elevação de 6dp usando uma cor secundária sem sobreposição
C. Uma barra de aplicativo inferior com elevação de 8dp e sobreposição de 12%
As sobreposições de elevação não são aplicadas às superfícies de componentes que usam cores primárias ou secundárias.
Em um tema escuro, as sombras permanecem escuras para representar com precisão uma sombra projetada.

Não faça

Não faça
Acessibilidade e contraste
As superfícies do tema escuro devem ser escuras o suficiente para exibir texto branco. Elas devem apresentar uma proporção de contraste de pelo menos 15.8:1 entre o texto e o plano de fundo. Isso garante que o texto de corpo atenda ao padrão AA do WCAG de pelo menos 4.5:1 nas superfícies com a elevação mais alta (e mais clara).

Se a cor do plano de fundo não for escura o suficiente para atingir uma proporção de contraste de pelo menos 15.8:1 entre o texto branco e a superfície, o texto não atenderá ao padrão de 4.5:1 na superfície com a elevação mais alta (e mais clara).

Atenção
UIs que exigem um uso eficiente da bateria podem usar preto puro. Nesses casos, alguns dispositivos (como wearables com telas OLED) podem desligar qualquer pixel que exiba preto para economizar bateria.
Atenção
Aplicação na UI
Cores do tema
Todas as cores do tema escuro devem proporcionar contraste suficiente para os elementos posicionados sobre elas, atendendo ao padrão AA do WCAG de pelo menos 4.5:1 para texto de corpo, em superfícies de todos os níveis de elevação.
Cores dessaturadas para acessibilidade
Um tema escuro deve evitar o uso de cores saturadas, pois elas não atendem ao padrão de acessibilidade do WCAG de pelo menos 4.5:1 para texto de corpo sobre superfícies escuras. Cores saturadas também produzem um efeito de vibração visual sobre um plano de fundo escuro, o que pode causar cansaço visual.
Em vez disso, use cores dessaturadas, que são uma alternativa mais legível.


Não faça
Cor primária
A cor primária é a cor exibida com mais frequência nas telas e nos componentes do seu app. O tema escuro de linha de base do Material Design usa o tom 200 da cor primária (atendendo ao padrão AA do WCAG de pelo menos 4.5:1 para texto normal, em superfícies de todos os níveis de elevação).

1. Indicador da cor primária
2. Variantes tonais
Variantes da cor primária
Componentes que têm superfícies claras podem exibir uma variação da cor primária do seu tema escuro.

Cor secundária
Uma cor secundária pode ser usada para dar destaque a partes específicas da sua UI. Em um tema escuro, uma cor secundária pode ser dessaturada para atender à proporção de contraste de 4.5:1.

1. Indicador da cor secundária
2. Variantes tonais

Cor de destaque
Em um tema escuro, as superfícies escuras ocupam a maior parte da UI. As cores de destaque são tipicamente claras (pastéis dessaturados) ou brilhantes (cores saturadas e vívidas), para que os elementos destacados se sobressaiam. Elas devem ser usadas com moderação, para realçar elementos-chave, como texto ou botões.
Encontrando cores de destaque
O gerador de paletas de cores pode ser usado para criar (ou visualizar) um tema de cores. Ele também gera paletas tonais, que são uma gama de variações de cor, do claro ao escuro, criadas a partir das suas cores primária e secundária. Você pode selecionar variações dessas paletas para o seu tema escuro.

1. Indicador da cor primária do tema padrão
2. Indicador da cor primária do tema escuro

Faça

Não faça


Cores da marca
Para manter a identidade da marca, as cores da marca podem ser usadas com saturação total em um tema escuro, embora o uso deva ser limitado a um ou dois elementos de marca, como um logotipo ou um botão da marca. Usadas com moderação, elas mantêm os elementos proeminentes na hierarquia.
Cores dessaturadas ainda devem ser usadas no restante da UI de tema escuro.

1. Cor primária do tema escuro
2. Cor da marca
A paleta de linha de base do tema escuro
O tema de linha de base do Material Design inclui paletas tonais para um tema escuro.
As cores do tema escuro devem ser usadas em toda a UI de tema escuro, incluindo:
- Cor (primária, secundária e variantes da cor primária)
- Superfícies (planos de fundo e componentes)
- Estados (como estados de erro)
- Conteúdo (tipografia e iconografia)


2. O tema escuro de linha de base do Material Design
Cores de erro
As cores de erro são usadas para indicar um estado de erro. A cor de erro do tema escuro de linha de base do Material é #CF6679.

Cores de tipografia e iconografia
Cores "On"
As cores "On" são aplicadas principalmente a texto, iconografia e traçados que às vezes são posicionados "sobre" superfícies-chave que usam uma cor primária, secundária, de superfície, de plano de fundo ou de erro.
Por padrão, as cores "On" do tema escuro são branco e preto.

Texto claro sobre planos de fundo escuros
Quando um texto claro aparece sobre planos de fundo escuros (mostrado aqui como branco sobre preto), aplicam-se os seguintes níveis de opacidade:
- O texto de alta ênfase tem opacidade de 87%
- O texto de média ênfase e o texto de dica têm opacidade de 60%
- O texto desativado tem opacidade de 38%

Aplicação personalizada
Alguns casos de uso no Material Design podem se beneficiar do uso de determinados elementos do tema escuro.
Superfícies grandes
Componentes que ocupam uma grande parte da tela, como uma barra de aplicativo ou um backdrop, podem aplicar o tema escuro à cor de superfície do componente.

Faça

Não faça

Atenção

Não faça
Combinando temas claros e escuros
Quando uma superfície clara é necessária em um tema escuro, é possível usar cores claras em algumas superfícies de componentes para preservar a hierarquia.
Por exemplo, um snackbar de tema escuro pode exibir uma superfície clara para se destacar. Para isso, ele pode aplicar as cores Surface e On Surface do tema claro.

1. On Surface: #FFFFFF
2. Surface: #121212
3. Primary Variant: #3700B3
Estados
Os estados comunicam visualmente o status de um componente ou de um elemento interativo por meio de sobreposições. Em um tema escuro, os estados devem usar os mesmos valores de sobreposição do tema padrão (ou claro) e podem ser ajustados para atender aos padrões de contraste de nível AA.
Há dois tipos de contêineres que herdam sobreposições de estado: contêineres que usam a cor "Surface" e contêineres que usam a cor "Primary".
Contêineres de superfície
Contêineres de superfície que usam a cor "Surface" devem aplicar uma sobreposição de estado que corresponda à cor do ícone ou, se não houver ícone, à cor do rótulo de texto.

| Contêiner | Surface |
| Conteúdo | On Surface |
| Cor da sobreposição | Herdada do conteúdo |

| Contêiner | Surface |
| Conteúdo | Primary |
| Cor da sobreposição | Herdada do conteúdo |
Contêineres primários
Para contêineres de superfície que usam a cor "Primary", a sobreposição de estado é branca.

| Contêiner | Primary 24% |
| Conteúdo | Primary |
| Cor da sobreposição | Branco |

| Contêiner | Primary |
| Conteúdo | On Primary |
| Cor da sobreposição | Branco |
Estados desativados
Todos os componentes desativados usam 12% de branco nos contornos e nos preenchimentos dos contêineres e 38% de branco no conteúdo, como rótulos e ícones.

2. Rótulo/Ícone: 38% de branco
3. Contêiner preenchido: 12% de branco
Recursos
Arquivos de design
Esses arquivos de design incluem elementos para layouts de tema escuro, como barras de status, barras de aplicativo, barras de ferramentas inferiores, cartões, menus suspensos, gavetas de navegação lateral, diálogos, botões de ação flutuantes e outros componentes.
Disponível sob a licença Apache 2.0. Ao baixar, você concorda com os Termos de Serviço do Google. A Política de Privacidade do Google descreve como os dados são tratados neste serviço.
Implementação
O suporte à implementação do tema escuro em cada plataforma está indicado abaixo.
| Plataforma | Suporte |
|---|---|
| Android | Disponível |
| iOS | Indisponível |
| Web | Indisponível |
| Flutter | Indisponível |