Tailwind CSS Modo oscuro

El modo oscuro (Dark Mode) es una tendencia común de diseño de interfaces de usuario, que ofrece una interfaz de tonos oscuros para reducir la fatiga visual y, a la vez, ahorrar batería del dispositivo.

Tailwind CSS admite la funcionalidad de modo oscuro (Dark Mode), lo que permite a los desarrolladores crear fácilmente versiones oscuras de los sitios web para adaptarse a las preferencias del sistema del usuario.

Tailwind CSS proporciona un modificador llamadodarkque te permite definir estilos para el modo oscuro.

Cuando el dispositivo o el sistema operativo del usuario esté configurado en modo oscuro, los estilos con eldark:modificador se aplicarán automáticamente.

El siguiente ejemplo define estilos basándose en la consulta de medios (media query) de las preferencias del sistema:

Ejemplo

<div class="bg-white text-black dark:bg-black dark:text-white">
Este texto cambia según el modo de color.
</div>

Pruébalo »

En el modo claro:El color de fondo es blanco (bg-white), y el color del texto es negro (text-black)。

En el modo oscuro:El color de fondo es negro (dark:bg-black), y el color del texto es blanco (dark:text-white)。


Habilitar el modo oscuro

De forma predeterminada, Tailwind usa la estrategia media para detectar el modo oscuro, es decir, basándose en las preferencias del sistema del usuario.

Si necesitas un control más detallado, también puedes usar la estrategia class.

1. Habilitar el modo oscuro en tailwind.config.js

Ejemplo

module.exports = {
  darkMode: 'media', // Basado en las preferencias del sistema (predeterminado)
  // darkMode: 'class', // Cambio manual basado en nombres de clase
  theme: {
    extend: {},
  },
  plugins: [],
}
  • mediaModo: según la configuración del sistema operativo del usuario (a través de la consulta de mediosprefers-color-scheme: dark) se alterna automáticamente.
  • classModo: permite al desarrollador, al añadir enhtmlobodyla etiquetadarkla clase para cambiar manualmente al modo oscuro.

Diferencias entre los dos modos:

ModoMétodo de detecciónMétodo de controlEscenario de uso
mediaModoConsulta de medios basada en las preferencias del sistemaCambio automáticoEscenarios de aplicación simples, sin lógica personalizada
classModoBasado en la adición manualhtmlobodyendarkClasela lógica de cambio es definida por el desarrollador.Escenarios complejos que requieren botones o interruptores

Ejemplo de lógica de conmutación (modo class)

Si quieres admitir el cambio manual del modo oscuro en lugar de depender de las preferencias del sistema operativo, usa la estrategia class en lugar de la estrategia media.

Ahora, la clase dark:{class} ya no funcionará según prefers-color-scheme, sino que funcionará cuando la clase dark aparezca en el árbol HTML:

<!-- 不允许深色模式 -->
<html>
<body>
  <div class="bg-white dark:bg-black">...</div>
</body>
</html>

<!-- 允许深色模式 -->
<html class="dark">
<body>
  <div class="bg-white dark:bg-black">...</div>
</body>
</html>

Ejemplo

<button id="toggle-dark-mode">Toggle Dark Mode</button>
<script>
const toggle = document.getElementById('toggle-dark-mode');
toggle.addEventListener('click', () => {
    document.documentElement.classList.toggle('dark');
});
</script>

Pruébalo »

Cómo usar las clases de utilidad del modo oscuro

1. Cambio de estilos

Usadark:el prefijo para especificar estilos en modo oscuro.

Ejemplo

<div class="bg-gray-200 dark:bg-gray-800 text-gray-900 dark:text-gray-100">
Un diseño adaptable a los modos claro y oscuro.
</div>

Pruébalo »

2. Combinación de diseño responsive y modo oscuro

Los puntos de interrupción responsive y el modo oscuro se pueden usar al mismo tiempo:

Ejemplo

<div class="text-lg sm:text-xl dark:text-gray-300 sm:dark:text-gray-500">
Texto responsive y compatible con el modo oscuro.
</div>

Pruébalo »

En pantallas pequeñas, el tamaño de fuente es xl.

En el modo oscuro, el color de la fuente en pantallas pequeñas se vuelve gris claro.

3. Combinación de estados interactivos con el modo oscuro

Puedes aplicar estilos combinando estados como hover, focus, etc., con el modo oscuro:

Ejemplo

<button class="bg-white dark:bg-black text-black dark:text-white hover:bg-gray-300 dark:hover:bg-gray-700">
Botón interactivo
</button>

Pruébalo »

Extender el modo oscuro

En algunos casos, es posible que necesites proporcionar colores o estilos adicionales para el modo oscuro; puedes personalizar la configuración de Tailwind mediante theme.extend.

module.exports = {
  theme: {
    extend: {
      colors: {
        brand: {
          DEFAULT: '#1DA1F2',
          dark: '#0D74B8',
        },
      },
    },
  },
}

Usa los colores extendidos en HTML:

Ejemplo

<div class="text-brand dark:text-brand-dark">
¡Colores personalizados para el modo oscuro!
</div>

Pruébalo »

Ejemplo

A continuación se muestra un ejemplo completo para implementar el cambio al modo oscuro:

Ejemplo

<div class="p-6">
<h1>Bienvenido al modo oscuro</h1>
<button id="toggle-dark-mode" class="mt-4 bg-gray-200 dark:bg-gray-700 text-black dark:text-white p-2 rounded">
Cambiar modo
</button>
</div>
<script>
const toggle = document.getElementById('toggle-dark-mode');
toggle.addEventListener('click', () => {
    const isDark = document.documentElement.classList.toggle('dark');
    localStorage.theme = isDark ? 'dark' : 'light';
});
</script>

Pruébalo »
Otras extensiones