Tema oscuro
Un tema oscuro es una interfaz de usuario (UI) de baja luminosidad que muestra principalmente superficies oscuras.

Uso
Un tema oscuro muestra superficies oscuras en la mayor parte de la interfaz. Está diseñado como un modo complementario al tema predeterminado (o claro).
Los temas oscuros reducen la luminancia que emiten las pantallas de los dispositivos, respetando al mismo tiempo las relaciones mínimas de contraste de color. Mejoran la ergonomía visual al reducir la fatiga ocular, ajustar el brillo a las condiciones de iluminación actuales y facilitar el uso de la pantalla en entornos oscuros, además de ahorrar batería. Los dispositivos con pantallas OLED se benefician de la posibilidad de apagar los píxeles negros en cualquier momento del día.
Principios

Oscurecer con gris
Usar gris oscuro, en lugar de negro, para representar la elevación y el espacio en un entorno con una gama más amplia de profundidad.

Aplicar acentos de color
Aplicar acentos de color limitados en las interfaces con tema oscuro, de modo que la mayor parte del espacio se destine a superficies oscuras.

Ahorrar energía
En productos que requieren eficiencia energética (como los dispositivos con pantallas OLED), prolongar la duración de la batería reduciendo el uso de píxeles claros.

Mejorar la accesibilidad
Tener en cuenta a los usuarios habituales del tema oscuro (como las personas con baja visión) y cumplir los estándares de accesibilidad de contraste de color.
Propiedades
Los temas oscuros de Material Design se definen por las siguientes propiedades:
- Contraste: Las superficies oscuras y el texto del cuerpo en blanco puro tienen una relación de contraste de al menos 15,8:1
- Profundidad: En niveles de elevación más altos, los componentes expresan la profundidad mostrando colores de superficie más claros
- Desaturación: Los colores primarios se desaturan para cumplir el estándar AA de las Pautas de Accesibilidad para el Contenido Web (WCAG) de al menos 4,5:1 (cuando se usan con texto del cuerpo) en todos los niveles de elevación
- Uso limitado de color: Las superficies grandes usan un color de superficie oscuro, con acentos de color limitados (colores claros y desaturados, y colores brillantes y saturados)
Anatomía
Las interfaces con tema oscuro usan principalmente superficies oscuras, con escasos acentos de color. Emiten niveles bajos de luz al tiempo que mantienen un alto nivel de usabilidad.

2. Surface (superposición de superficie a 1 dp de elevación)
3. Primary
4. Secondary
5. On Background
6. On Surface
7. On Primary
8. On Secondary
Comportamiento
Un tema oscuro se puede activar (o desactivar) mediante un control que se muestra:
- De forma destacada: un interruptor de icono para activar o desactivar el tema
- Con menor prominencia: un interruptor situado dentro de un menú o en los ajustes de la aplicación



Propiedades
Un tema oscuro usa gris oscuro, en lugar de negro, como color de superficie principal para los componentes. Las superficies de gris oscuro pueden transmitir una gama más amplia de color, elevación y profundidad, porque es más fácil ver las sombras sobre el gris que sobre el negro.
Las superficies de gris oscuro también reducen la fatiga ocular, ya que el texto claro sobre una superficie de gris oscuro genera menos contraste que sobre una superficie negra.

Elevación
En un tema oscuro, los componentes conservan los mismos niveles de elevación predeterminados y las mismas sombras que los componentes del tema claro. Sin embargo, las superficies de los distintos niveles de elevación se iluminan de forma diferente.
Mayor elevación, superficie más clara
Cuanto más elevada esté una superficie (es decir, cuanto más cerca esté de una fuente de luz implícita), más clara se vuelve. Esa mayor luminosidad se expresa mediante la aplicación de una superposición semitransparente que usa el color On Surface.
Una superficie de tema oscuro se construye aplicando una superposición semitransparente sobre la superficie de un componente.

1. Surface
2. Superposición de elevación
Una superposición sobre una superficie también facilita distinguir las diferencias de elevación entre los componentes y ver las sombras. Las superposiciones añaden contraste entre las superficies y sus sombras, lo que hace que los bordes de cada superficie sean más visibles.
Estos valores de superposición de la superficie están diseñados para maximizar la legibilidad, al tiempo que garantizan que los distintos niveles de elevación se distingan entre sí.

| Nivel de elevación | Transparencia de la superposición blanca |
|---|---|
| 00dp | 0 % |
| 01dp | 5 % |
| 02dp | 7 % |
| 03dp | 8 % |
| 04dp | 9 % |
| 06dp | 11 % |
| 08dp | 12 % |
| 12dp | 14 % |
| 16dp | 15 % |
| 24dp | 16 % |
Las superposiciones hacen más evidente la diferencia de elevación entre los componentes.

B. Un botón de acción flotante con una elevación de 6 dp que usa un color secundario sin superposición
C. Una barra de aplicaciones inferior con una elevación de 8 dp y una superposición del 12 %
Las superposiciones de elevación no se aplican a las superficies de los componentes que usan colores primarios o secundarios.
En un tema oscuro, las sombras permanecen oscuras para representar con precisión una sombra proyectada.

Incorrecto

Incorrecto
Accesibilidad y contraste
Las superficies de un tema oscuro deben ser lo bastante oscuras para mostrar texto blanco. Deben mantener una relación de contraste de al menos 15,8:1 entre el texto y el fondo. Esto garantiza que el texto del cuerpo cumpla el estándar AA de la WCAG de al menos 4,5:1 cuando se aplica sobre las superficies de elevación más alta (y más clara).

Si el color de fondo no es lo bastante oscuro como para alcanzar una relación de contraste de al menos 15,8:1 entre el texto blanco y la superficie, el texto sobre la superficie de elevación más alta (y más clara) no cumplirá el estándar de 4,5:1.

Precaución
Las interfaces que requieren un uso eficiente de la batería pueden usar negro puro. En estos casos, algunos dispositivos (como los dispositivos wearables con pantallas OLED) pueden apagar los píxeles negros para ahorrar batería.
Precaución
Aplicación en la UI
Colores del tema
Todos los colores del tema oscuro deben mostrar los elementos con un contraste suficiente y cumplir el estándar AA de la WCAG de al menos 4,5:1 para el texto del cuerpo sobre superficies de todos los niveles de elevación.
Colores desaturados para la accesibilidad
Un tema oscuro debe evitar el uso de colores saturados, ya que no cumplen el estándar de accesibilidad de la WCAG de al menos 4,5:1 para el texto del cuerpo sobre superficies oscuras. Los colores saturados también producen vibración visual sobre un fondo oscuro, lo que puede provocar fatiga ocular.
En su lugar, se pueden usar colores desaturados como alternativa más legible.


Incorrecto
Color primario
El color primario es el que se muestra con mayor frecuencia en las pantallas y componentes de la aplicación. El tema oscuro de referencia de Material Design usa el tono 200 del color primario (que cumple el estándar AA de la WCAG de al menos 4,5:1 para el texto normal en todas las superficies de elevación).

1. Indicador del color primario
2. Variantes tonales
Variantes del color primario
Los componentes con superficies claras pueden usar una variante del color primario del tema oscuro.

Color secundario
Se puede usar un color secundario para resaltar determinadas partes de la interfaz. En un tema oscuro, un color secundario puede desaturarse para cumplir una relación de contraste de 4,5:1.

1. Indicador del color secundario
2. Variantes tonales

Color de acento
En un tema oscuro, las superficies oscuras ocupan la mayor parte de la interfaz. Los colores de acento suelen ser claros (tonos pastel desaturados) o brillantes (colores saturados y vivos) para que los elementos acentuados destaquen. Deben usarse con moderación, a fin de resaltar elementos clave como el texto o los botones.
Cómo encontrar colores de acento
El generador de paletas de colores permite crear (o ver) un tema de color. También genera paletas tonales, que son gamas de variaciones de color que van de claro a oscuro, creadas a partir de los colores primario y secundario. Se pueden seleccionar variaciones de estas paletas para el tema oscuro.

1. Indicador del color primario del tema predeterminado
2. Indicador del color primario del tema oscuro

Correcto

Incorrecto


Colores de marca
Para conservar la identidad de marca, los colores de marca pueden usarse a plena saturación en un tema oscuro, aunque su aplicación debe limitarse a uno o dos elementos de marca, como un logotipo o un botón de marca. Si se usan con moderación, siguen destacando en la jerarquía.
Los colores desaturados deben seguir usándose en el resto de la interfaz del tema oscuro.

1. Color primario del tema oscuro
2. Color de marca
La paleta de referencia del tema oscuro
El tema de referencia de Material Design incluye paletas tonales para un tema oscuro.
Los colores del tema oscuro deben usarse en toda la interfaz, incluidos los siguientes elementos:
- Color (primario, secundario y variantes del color primario)
- Superficies (fondos y componentes)
- Estados (como los estados de error)
- Contenido (tipografía e iconografía)


2. El tema oscuro de referencia de Material Design
Colores de error
Los colores de error se usan para indicar un estado de error. El color de error del tema oscuro de referencia de Material es #CF6679.

Colores de tipografía e iconografía
Colores "On"
Los colores "On" se aplican principalmente al texto, a la iconografía y a los trazos. A veces se colocan "sobre" superficies clave que usan un color primario, secundario, de superficie, de fondo o de error.
De forma predeterminada, los colores "On" del tema oscuro son el blanco y el negro.

Texto claro sobre fondos oscuros
Cuando un texto claro aparece sobre fondos oscuros (como se muestra aquí: blanco sobre negro), debe usar los siguientes niveles de opacidad:
- El texto de énfasis alto tiene una opacidad del 87 %
- El texto de énfasis medio y el texto de ayuda tienen una opacidad del 60 %
- El texto deshabilitado tiene una opacidad del 38 %

Aplicación personalizada
Algunos casos de uso de Material Design pueden beneficiarse del uso de determinados elementos del tema oscuro.
Superficies grandes
Los componentes que ocupan una gran parte de la pantalla, como una barra de aplicaciones o un backdrop, pueden usar el color de superficie del tema oscuro.

Correcto

Incorrecto

Precaución

Incorrecto
Combinar temas claros y oscuros
Cuando se necesita una superficie clara en un tema oscuro, se puede usar un color claro en las superficies de determinados componentes para mantener la jerarquía.
Por ejemplo, un snackbar en un tema oscuro puede mostrar una superficie clara para que destaque. Para lograrlo, puede aplicar los colores Surface y On Surface del tema claro.

1. On Surface: #FFFFFF
2. Surface: #121212
3. Primary Variant: #3700B3
Estados
El estado de un componente o elemento interactivo se comunica visualmente mediante superposiciones. En un tema oscuro, los estados deben usar los mismos valores de superposición que su tema predeterminado (o claro), y pueden ajustarse para cumplir los estándares de contraste de nivel AA.
Hay dos tipos de contenedores que heredan superposiciones de estado: los contenedores que usan el color "Surface" y los que usan el color "Primary".
Contenedores de superficie
Los contenedores que usan el color "Surface" deben aplicar una superposición que coincida con el color de su icono o, si no lo hay, con el de su etiqueta de texto.

| Contenedor | Surface |
| Contenido | On Surface |
| Color de superposición | Heredado del contenido |

| Contenedor | Surface |
| Contenido | Primary |
| Color de superposición | Heredado del contenido |
Contenedores de color primario
Para los contenedores que usan el color "Primary", la superposición de estado es blanca.

| Contenedor | Primary 24 % |
| Contenido | Primary |
| Color de superposición | Blanco |

| Contenedor | Primary |
| Contenido | On Primary |
| Color de superposición | Blanco |
Estados deshabilitados
Todos los componentes deshabilitados se muestran con un 12 % de blanco para los bordes y rellenos del contenedor, y un 38 % de blanco para el contenido, como etiquetas o iconos.

2. Etiqueta/Icono: 38 % de blanco
3. Contenedor relleno: 12 % de blanco
Recursos
Archivos de diseño
Estos archivos de diseño incluyen elementos para maquetas de tema oscuro, como barras de estado, barras de aplicaciones, barras de herramientas inferiores, tarjetas, menús desplegables, menús de navegación lateral, diálogos, botones de acción flotante y otros componentes.
Disponibles bajo la licencia Apache 2.0. Al descargarlos, se aceptan los Términos del Servicio de Google. La Política de Privacidad de Google describe cómo se gestionan los datos en este servicio.
Implementación
A continuación, se indica la compatibilidad de cada plataforma con la implementación del tema oscuro.
| Plataforma | Estado |
|---|---|
| Android | Disponible |
| iOS | No disponible |
| Web | No disponible |
| Flutter | No disponible |