Tema 12 · Modo Oscuro (Dark Mode)

12. Modo Oscuro (Dark Mode): Estrategia "class" vs "media", Persistencia con LocalStorage

Implementa un conmutador de tema oscuro profesional con darkMode: "class", utilidades dark:bg-slate-900 dark:text-white y sincronización con las preferencias del sistema.

La Necesidad del Modo Oscuro en Aplicaciones Modernas

El soporte para temas oscuros (Dark Mode) ya no es un lujo estético, sino un requisito de ergonomía visual y accesibilidad. Reduce la fatiga ocular nocturna y prolonga la batería en pantallas OLED/AMOLED de dispositivos móviles y portátiles.

Las Dos Estrategias: "media" vs "class"

En el archivo tailwind.config.js puedes definir cómo se activa la variante dark::

1. Estrategia "media" (Por Defecto)

Utiliza la media query CSS @media (prefers-color-scheme: dark). Cambia automáticamente según el tema del sistema operativo, pero no le permite al usuario alternar manualmente mediante un botón en la web.

2. Estrategia "class" (Estándar Profesional)

Se activa cuando la etiqueta raíz <html class="dark"> posee la clase dark. Permite crear botones conmutadores con JavaScript y memorizar la elección en localStorage.

Diseñando con el Prefijo dark:

Para adaptar cualquier elemento al modo oscuro, simplemente añade la versión clara como base y la oscura con el prefijo dark::

<!-- Tarjeta adaptativa: Fondo blanco en día, pizarra oscura en noche -->
<div class="bg-white dark:bg-slate-900 text-slate-800 dark:text-slate-100 border border-slate-200 dark:border-slate-800 rounded-xl p-6 shadow-sm">
  Contenido adaptativo a cualquier entorno de iluminación
</div>

Prevención del Destello Blanco (Flash of Unstyled Content)

Para evitar que una pantalla blanca molesta parpadee antes de que cargue la aplicación, se debe colocar un pequeño script síncrono en el <head> del documento HTML antes de cualquier hoja de estilos:

<script>
  if (localStorage.theme === 'dark' || (!('theme' in localStorage) && window.matchMedia('(prefers-color-scheme: dark)').matches)) {
    document.documentElement.classList.add('dark');
  } else {
    document.documentElement.classList.remove('dark');
  }
</script>

⚡ Componente de Tarjeta con Switch de Modo Oscuro y JavaScript Inline

Tarjeta con estilos claros y oscuros combinados con un script para alternar la clase dark en <html>:

dark-mode-toggle.html
Solo lectura
<!-- Contenedor de Demostración Adaptable al Modo Oscuro -->
<div class="max-w-md mx-auto p-6 bg-white dark:bg-slate-900 border border-slate-200 dark:border-slate-800 rounded-2xl shadow-lg transition-colors duration-300">
  
  <div class="flex items-center justify-between mb-4">
    <span class="text-xs font-bold uppercase tracking-wider text-cyan-600 dark:text-cyan-400">
      Ajustes de Interfaz
    </span>

    <!-- Botón para Conmutar Modo Oscuro -->
    <button onclick="document.documentElement.classList.toggle('dark')" 
            class="p-2 rounded-xl bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-300 hover:ring-2 hover:ring-cyan-500 transition">
      <!-- Icono de Sol / Luna -->
      <span class="dark:hidden">🌙 Modo Noche</span>
      <span class="hidden dark:inline">☀️ Modo Día</span>
    </button>
  </div>

  <h3 class="text-xl font-bold text-slate-900 dark:text-white mb-2">
    Experiencia de Lectura Nocturna
  </h3>

  <p class="text-sm text-slate-600 dark:text-slate-400 leading-relaxed mb-6">
    Observa cómo el fondo, los textos, los bordes y las sombras cambian suavemente al alternar la clase <code class="px-1.5 py-0.5 rounded bg-slate-100 dark:bg-slate-800 text-cyan-600 dark:text-cyan-400">dark</code> en el elemento raíz del DOM.
  </p>

  <div class="p-4 rounded-xl bg-slate-50 dark:bg-slate-800/50 border border-slate-100 dark:border-slate-700/50 flex items-center justify-between">
    <span class="text-xs font-medium text-slate-500 dark:text-slate-400">Sincronizado con Kilopolis</span>
    <span class="w-2.5 h-2.5 rounded-full bg-emerald-500"></span>
  </div>

</div>
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué configuración se debe especificar en tailwind.config.js para poder alternar el modo oscuro manualmente agregando la clase "dark" a la etiqueta <html>?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Tailwind CSS: Framework Utility-First Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.