Tema scuro
Un tema scuro è un'interfaccia utente a bassa luminosità, caratterizzata da superfici per lo più scure.

Utilizzo
Un tema scuro mostra superfici scure sulla maggior parte dell'interfaccia utente. È progettato come modalità complementare a un tema predefinito (o chiaro).
I temi scuri riducono la luminanza emessa dagli schermi dei dispositivi, nel rispetto dei rapporti di contrasto cromatico minimi. Contribuiscono a migliorare l'ergonomia visiva: riducono l'affaticamento degli occhi, adattano la luminosità alle condizioni di illuminazione del momento e facilitano l'uso dello schermo in ambienti bui, riducendo inoltre il consumo della batteria. I dispositivi con schermi OLED traggono vantaggio dalla possibilità di spegnere i pixel neri in qualsiasi momento.
Principi

Scurire con il grigio
Usa il grigio scuro – invece del nero – per esprimere elevazione e spazio in un ambiente dotato di una gamma di profondità più ampia.

Accenti di colore
Applica accenti di colore limitati nelle UI a tema scuro, in modo da riservare la maggior parte dello spazio alle superfici scure.

Risparmiare energia
Nei prodotti con requisiti di efficienza energetica (come i dispositivi con schermi OLED), preserva l'autonomia della batteria riducendo l'uso di pixel luminosi.

Migliorare l'accessibilità
Tieni conto delle esigenze di chi usa abitualmente il tema scuro (ad esempio le persone ipovedenti), rispettando gli standard di accessibilità sul contrasto cromatico.
Proprietà
I temi scuri di Material Design sono definiti dalle seguenti proprietà:
- Contrasto: le superfici scure e il testo del corpo bianco a piena opacità (100%) presentano un rapporto di contrasto di almeno 15,8:1
- Profondità: a livelli di elevazione più alti, i componenti esprimono profondità mostrando colori di superficie più chiari
- Desaturazione: i colori primari vengono desaturati per rispettare lo standard AA delle Web Content Accessibility Guidelines (WCAG), garantendo un rapporto di contrasto di almeno 4,5:1 con il testo del corpo, a tutti i livelli di elevazione
- Uso limitato del colore: le superfici ampie usano un colore di superficie scuro, con accenti di colore limitati (colori chiari e desaturati oppure brillanti e saturi)
Anatomia
Le interfacce a tema scuro usano superfici prevalentemente scure, con pochi accenti cromatici: emettono poca luce mantenendo un elevato livello di usabilità.

2. Surface (con overlay di superficie a elevazione 1dp)
3. Primary
4. Secondary
5. On background
6. On Surface
7. On Primary
8. On Secondary
Comportamento
Un tema scuro può essere attivato o disattivato tramite un controllo di attivazione posizionato:
- In evidenza, con un interruttore a icona che attiva o disattiva il tema
- Con minore evidenza, tramite un interruttore collocato in un menu o nelle impostazioni dell'app



Proprietà
Un tema scuro usa il grigio scuro, invece del nero, come colore di superficie principale per i componenti. Le superfici in grigio scuro possono esprimere una gamma più ampia di colore, elevazione e profondità, poiché le ombre sono più facili da distinguere sul grigio che sul nero.
Le superfici in grigio scuro riducono inoltre l'affaticamento degli occhi: il testo chiaro su una superficie grigio scuro genera meno contrasto rispetto al testo chiaro su una superficie nera.

Elevazione
In un tema scuro, i componenti mantengono gli stessi livelli di elevazione predefiniti e le stesse ombre dei componenti nei temi più chiari. Tuttavia, le superfici con livelli di elevazione diversi vengono illuminate in modo differente.
Elevazione più alta, superficie più chiara
Più alta è l'elevazione di una superficie (che la avvicina a una sorgente luminosa implicita), più chiara diventa la superficie. Tale luminosità è espressa tramite l'applicazione di un overlay semi-trasparente del colore On Surface.
La superficie di un tema scuro è costruita applicando un overlay semi-trasparente sopra la superficie di un componente.

1. Surface
2. Overlay di elevazione
Un overlay applicato a una superficie rende inoltre più agevole distinguere i livelli di elevazione tra i componenti e individuare le ombre: aumenta il contrasto tra le superfici e le rispettive ombre, rendendo più evidenti i bordi di ogni superficie.
I valori degli overlay di superficie sono progettati per massimizzare la leggibilità, garantendo al tempo stesso che i diversi livelli di elevazione restino distinguibili tra loro.

| Livello di elevazione | Trasparenza dell'overlay bianco |
|---|---|
| 00dp | 0% |
| 01dp | 5% |
| 02dp | 7% |
| 03dp | 8% |
| 04dp | 9% |
| 06dp | 11% |
| 08dp | 12% |
| 12dp | 14% |
| 16dp | 15% |
| 24dp | 16% |
Gli overlay chiariscono la differenza di elevazione tra i componenti.

B. Un pulsante d’azione flottante a un'elevazione di 6dp, che usa un colore secondario senza overlay
C. Una barra dell’applicazione inferiore a 8dp di elevazione con un overlay del 12%
Gli overlay di elevazione non vengono applicati alle superfici dei componenti che usano colori primari o secondari.
In un tema scuro, le ombre restano scure per rappresentare fedelmente un'ombra proiettata.

Da non fare

Da non fare
Accessibilità e contrasto
Le superfici del tema scuro devono essere abbastanza scure da consentire l'uso di testo bianco, garantendo un rapporto di contrasto di almeno 15,8:1 tra testo e sfondo. In questo modo il testo del corpo rispetta lo standard AA delle WCAG (almeno 4,5:1) anche sulle superfici a elevazione più alta, e quindi più chiare.

Se il colore di sfondo non è abbastanza scuro da raggiungere un rapporto di contrasto di almeno 15,8:1 tra il testo bianco e la superficie, il testo sulla superficie a elevazione più alta (e più chiara) non rispetterà lo standard di 4,5:1.

Attenzione
Le interfacce che richiedono un uso efficiente della batteria possono usare il nero puro. In questi casi, alcuni dispositivi (come i dispositivi indossabili con schermi OLED) possono spegnere i pixel che visualizzano il nero per risparmiare batteria.
Attenzione
Applicazione nella UI
Colori del tema
Tutti i colori del tema scuro dovrebbero garantire un contrasto sufficiente agli elementi, rispettando lo standard AA delle WCAG (almeno 4,5:1) per il testo del corpo a tutti i livelli di elevazione.
Colori desaturati per l'accessibilità
Un tema scuro dovrebbe evitare l'uso di colori saturi: non rispettano lo standard di accessibilità delle WCAG di almeno 4,5:1 per il testo del corpo su superfici scure. I colori saturi producono anche vibrazioni ottiche su uno sfondo scuro, che possono causare affaticamento degli occhi.
In alternativa, è possibile usare colori desaturati, più leggibili.


Da non fare
Colore primario
Un colore primario è il colore mostrato più frequentemente nelle schermate e nei componenti della tua app. Il tema scuro di riferimento di Material Design usa la tonalità 200 del colore primario, che rispetta lo standard AA delle WCAG con un rapporto di contrasto di almeno 4,5:1 per il testo normale, a tutti i livelli di elevazione.

1. Indicatore del colore primario
2. Varianti tonali
Varianti del colore primario
I componenti con superfici chiare possono mostrare una variante del colore primario del tuo tema scuro.

Colore secondario
Un colore secondario può essere usato per dare risalto a parti specifiche della tua UI. In un tema scuro, un colore secondario può essere desaturato per raggiungere un rapporto di contrasto di 4,5:1.

1. Indicatore del colore secondario
2. Varianti tonali

Colore di accento
In un tema scuro, le superfici scure occupano la maggior parte della UI. I colori di accento sono in genere chiari (tonalità pastello desaturate) o brillanti (colori saturi e vivaci), per far risaltare gli elementi su cui sono applicati. Vanno usati con parsimonia, per accentuare gli elementi chiave, come il testo o i pulsanti.
Trovare i colori di accento
Il generatore di palette di colori consente di creare (o visualizzare) un tema cromatico. Genera anche palette tonali, ovvero una gamma di varianti di colore dal chiaro allo scuro, derivate dai tuoi colori primario e secondario. Puoi selezionare da queste palette le varianti da usare nel tema scuro.

1. Indicatore del colore primario del tema predefinito
2. Indicatore del colore primario del tema scuro

Da fare

Da non fare


Colori del brand
Per preservare l'identità del brand, i colori del brand possono essere usati a piena saturazione in un tema scuro, ma solo su uno o due elementi del brand, come un logo o un pulsante. Usati con parsimonia, aiutano questi elementi a distinguersi nella gerarchia.
Nel resto della UI a tema scuro si continuano a usare colori desaturati.

1. Colore primario del tema scuro
2. Colore del brand
La palette di riferimento del tema scuro
Il tema di riferimento di Material Design include palette tonali per un tema scuro.
I colori del tema scuro dovrebbero essere usati in tutta l'interfaccia a tema scuro, tra cui:
- Colori (primario, secondario e varianti del colore primario)
- Superfici (sfondi e componenti)
- Stati (come gli stati di errore)
- Contenuto (tipografia e iconografia)


2. Il tema scuro di riferimento di Material Design
Colori di errore
I colori di errore sono usati per indicare uno stato di errore. Il colore di errore del tema scuro di riferimento di Material è #CF6679.

Colori di tipografia e iconografia
Colori "On"
I colori "On" sono applicati principalmente al testo, all'iconografia e, talvolta, ai contorni posizionati "sopra" le superfici chiave che usano un colore primario, secondario, di superficie, di sfondo o di errore.
Per impostazione predefinita, i colori "On" del tema scuro sono il bianco e il nero.

Testo chiaro su sfondi scuri
Quando il testo chiaro compare su sfondi scuri (mostrato qui come bianco su nero), si applicano i seguenti livelli di opacità:
- Il testo ad alta enfasi ha un'opacità dell'87%
- Il testo a media enfasi e il testo di suggerimento hanno un'opacità del 60%
- Il testo disabilitato ha un'opacità del 38%

Applicazione personalizzata
Alcuni casi d'uso in Material Design possono trarre vantaggio dall'uso di elementi selezionati del tema scuro.
Superfici ampie
I componenti che occupano una porzione ampia dello schermo, come una barra dell’applicazione o un backdrop, possono usare il tema scuro per il proprio colore di superficie.

Da fare

Da non fare

Attenzione

Da non fare
Combinare temi chiari e scuri
Quando in un tema scuro è necessaria una superficie chiara, si possono usare colori chiari su alcune superfici dei componenti per preservare la gerarchia.
Ad esempio, uno snackbar a tema scuro può mostrare una superficie chiara per risaltare: a tale scopo, può applicare i colori Surface e On Surface del tema chiaro.

1. On Surface: #FFFFFF
2. Surface: #121212
3. Variante primaria: #3700B3
Stati
Gli stati comunicano visivamente la condizione di un componente o di un elemento interattivo tramite l'uso di overlay. In un tema scuro, gli stati dovrebbero usare gli stessi valori di overlay del tema predefinito (o chiaro) e possono essere regolati per rispettare lo standard di contrasto AA.
Esistono due tipi di contenitori che ereditano gli overlay di stato: i contenitori che usano il colore "Surface" e quelli che usano il colore "Primary".
Contenitori Surface
I contenitori che usano il colore "Surface" dovrebbero applicare un overlay dello stesso colore dell'icona o, in assenza di icona, dell'etichetta di testo.

| Contenitore | Surface |
| Contenuto | On Surface |
| Colore dell'overlay | Ereditato dal contenuto |

| Contenitore | Surface |
| Contenuto | Primary |
| Colore dell'overlay | Ereditato dal contenuto |
Contenitori Primary
Per i contenitori che usano il colore "Primary", l'overlay di stato è bianco.

| Contenitore | Primary 24% |
| Contenuto | Primary |
| Colore dell'overlay | Bianco |

| Contenitore | Primary |
| Contenuto | On Primary |
| Colore dell'overlay | Bianco |
Stati disabilitati
Tutti i componenti disabilitati sono visualizzati con un bianco al 12% per i contorni e i riempimenti dei contenitori, e con un bianco al 38% per i contenuti, come etichette o icone.

2. Etichetta/icona: 38% bianco
3. Contenitore con riempimento: 12% bianco
Risorse
File di design
Questi file di design includono elementi per i layout a tema scuro, come barre di stato, barre dell’applicazione, barre degli strumenti inferiori, schede, menu a discesa, barre di navigazione laterali, finestre di dialogo, pulsanti d’azione flottanti e altri componenti.
Disponibile con licenza Apache 2.0. Scaricando il file, accetti i Termini di servizio di Google. L'Informativa sulla privacy di Google descrive come vengono trattati i dati in questo servizio.
Implementazione
Lo stato del supporto per l'implementazione del tema scuro su ciascuna piattaforma è indicato di seguito.
| Piattaforma | Stato |
|---|---|
| Android | Disponibile |
| iOS | Non disponibile |
| Web | Non disponibile |
| Flutter | Non disponibile |