Dark Mode 2026 bien hecho: light-dark(), color-scheme y prefers-color-scheme

Implementar dark mode en 2026 ya no es duplicar todo tu CSS ni gestionar 50 variables a mano. Con light-dark(), color-scheme y prefers-color-scheme bien combinados, lo tienes funcionando en una mañana, con código limpio y respetando la preferencia del sistema del usuario.

Te paso la receta que aplico en proyectos reales. Sin negro puro, sin contrastes agresivos, con toggle de tres estados y sin librerías externas. Manos a la obra.

Las tres piezas que tienes que entender

  • color-scheme: le dice al navegador qué modos soporta tu web. Afecta a scrollbar, inputs de formulario y color de selección de texto.
  • prefers-color-scheme: media query que detecta la preferencia del sistema operativo del usuario.
  • light-dark(): función CSS que define dos valores de color en una sola declaración, y el navegador elige el correcto según el modo activo.

Configuración mínima

:root {
  color-scheme: light dark;
}

Con eso, tu web ya responde a la preferencia del sistema. Scrollbar, inputs y resalto de selección cambian automáticamente. Una línea, cero esfuerzo.

Aplicar light-dark() a tus colores

Define las dos paletas en variables personalizadas y pide a tus propiedades que usen light-dark().

:root {
  color-scheme: light dark;
  --bg: light-dark(#ffffff, #0f1115);
  --text: light-dark(#111827, #e6e6e6);
  --brand: light-dark(#2E5AAC, #6E9CFF);
}
 
body {
  background: var(--bg);
  color: var(--text);
}

El navegador elige el valor correcto según el modo activo. Cero duplicación de reglas, código limpio.

Un detalle que se pasa por alto: si declaras background: var(--bg) directamente sin fallback, cuidado. El navegador que no entiende light-dark() ignora la propiedad entera. Para que nunca se rompa, declara primero un color plano y luego la versión con light-dark(). El navegador se queda con la última declaración válida que entiende.

body {
  background: #ffffff; /* fallback para navegadores sin soporte */
  background: var(--bg);
}

Permitir override manual con toggle

Tres estados: claro, oscuro, sistema (por defecto). Aplica un atributo en el html.

:root[data-theme="light"] { color-scheme: light; }
:root[data-theme="dark"] { color-scheme: dark; }
/* sin data-theme: respeta el sistema */

JavaScript mínimo para alternar entre los tres estados y persistir la elección en localStorage:

const saved = localStorage.getItem('theme');
if (saved) document.documentElement.dataset.theme = saved;
 
function setTheme(theme) {
  if (theme === 'auto') {
    delete document.documentElement.dataset.theme;
    localStorage.removeItem('theme');
  } else {
    document.documentElement.dataset.theme = theme;
    localStorage.setItem('theme', theme);
  }
}

Detalles que diferencian un buen dark mode de uno cutre

  • Nada de negro puro #000: usa #0f1115 o similar. El negro puro cansa la vista y exagera el contraste.
  • Nada de blanco puro en textos: usa #e6e6e6. Es más cómodo de leer en pantallas OLED y LCD por igual.
  • Sombras al revés: en modo claro las sombras son negras suaves. En oscuro, una sombra negra es invisible sobre fondo oscuro, así que eleva con un halo de luz sutil o retira la sombra directamente.
  • Imágenes: revisa que se vean bien en los dos modos. Los logos con fondo blanco transparente quedan raros en dark.
  • Iconos: si son SVG, usa currentColor para que se adapten automáticamente al color del texto.
  • Bordes: reduce su opacidad. Los bordes muy saturados se ven duros en dark mode.

Imágenes que cambian según modo

Para imágenes raster (PNG, JPG) usa picture con media query.

<picture>
  <source srcset="logo-dark.png" media="(prefers-color-scheme: dark)">
  <img src="logo-light.png" alt="Logo">
</picture>

Compatibilidad real en 2026

light-dark() alcanzó Baseline «newly available» en mayo de 2024. Hoy cubre cerca del 90% del tráfico global según Can I Use. Los mínimos: Chrome y Edge 123, Firefox 120, Safari e iOS Safari 17.5. No es todavía Baseline «widely available» — ese salto llega dos años y medio después de la fecha de disponibilidad, hacia finales de 2026. Para uso en producción, ya es una apuesta segura.

color-scheme y prefers-color-scheme son mucho más veteranos: soportados de forma amplia desde 2022. Si te queda tráfico residual en navegadores muy antiguos, ten cuidado. El fallback que viste arriba marca la diferencia entre «se ve raro en un 2% de las visitas» y «se rompe».

Tip: si quieres entender por dentro cómo combinar dark mode con design tokens y sistemas de diseño, échale un vistazo a Udemy. Tienen cursos avanzados de CSS moderno con un módulo entero dedicado al tema.

Implementar en WordPress

  1. Añade color-scheme y las variables con light-dark() en el CSS adicional del tema (Personalizar → CSS adicional, o el archivo de tu tema hijo).
  2. Coloca un toggle en el header con tres botones (claro, oscuro, sistema).
  3. Inserta el JavaScript mínimo con wp_enqueue_script desde el functions.php de tu tema hijo, no directamente en el tema padre.
  4. Audita tus imágenes destacadas: las que tengan fondo blanco transparente, sustitúyelas por SVG o duplícalas para cada modo.
  5. Revisa el contraste en ambos modos con WAVE o axe DevTools antes de dar el cambio por cerrado.

Test rápido para validar tu dark mode

  1. Activa el modo oscuro a nivel de sistema operativo y carga tu web.
  2. Revisa cada página: ¿el texto es legible?, ¿las imágenes son coherentes?, ¿los formularios se ven bien?
  3. Mide el contraste en al menos 5 zonas distintas con WAVE.
  4. Prueba el toggle manualmente: claro, oscuro, sistema. Debe persistir tras recargar la página.
  5. Visita la web una vez con prefers-reduced-motion activado para comprobar que las transiciones de tema no generan movimiento excesivo.

¿Prefieres que te lo implemente yo directamente, sin liarte con variables ni tokens? Lo incluyo dentro de mis servicios de diseño web.

Aviso: si quieres que te avise cuando publique más guías de CSS moderno como esta, apúntate a mi newsletter.

Más recursos relacionados

Preguntas frecuentes

¿Qué es light-dark()?

Es una función CSS que define dos valores para un color: uno para modo claro, otro para modo oscuro. El navegador elige automáticamente según el esquema activo. Sintaxis: color: light-dark(black, white). Llegó a Baseline «newly available» en mayo de 2024.

¿Necesito JavaScript para dark mode?

Si solo respetas la preferencia del sistema (prefers-color-scheme), no. Si además permites que el usuario cambie manualmente, sí necesitas JavaScript mínimo para alternar entre los tres estados (claro, oscuro, sistema).

¿Qué hace color-scheme?

Indica al navegador qué modos de color soporta tu web. Cambia el aspecto de elementos nativos como scrollbar, inputs de formulario y resaltado de selección para que coincidan con el modo activo.

¿prefers-color-scheme sigue siendo necesario si uso light-dark()?

Sí, aunque light-dark() simplifica mucho el día a día. Hay casos donde necesitas más control: cambiar imágenes, ajustar sombras, intercambiar iconos. Para eso sigues usando @media (prefers-color-scheme: dark) directamente.

¿Cómo persisto la elección del usuario?

Con localStorage y tres estados: «light», «dark» o ausencia de valor (sistema). Lees el valor al cargar la página y aplicas el atributo data-theme al html. El CSS responde con selectores [data-theme="dark"] combinados con light-dark().

¿Afecta el dark mode al SEO?

Indirectamente. Mejora la experiencia de usuario, la accesibilidad y el tiempo en el sitio. Google no posiciona mejor por tener dark mode, pero las señales que sí observa (permanencia, accesibilidad) mejoran con una buena implementación.

¿Cuáles son los errores más típicos?

Negro puro #000 sobre blanco puro #fff: contraste agresivo que cansa la vista. No probar las imágenes en dark mode, y olvidar ajustar las sombras, que se vuelven invisibles. También ignorar elementos de marca con colores fijos que no reaccionan al cambio de modo.

¿Cómo afecta esto a la accesibilidad WCAG?

Tienes que cumplir el nivel AA en ambos modos: contraste mínimo de 4.5:1 para texto normal y 3:1 para texto grande. En dark mode los contrastes a veces se invierten de forma inesperada. Revísalos siempre por separado: no asumas que si pasa en claro, pasa en oscuro.

Tienes tres caminos

Si no tienes dark mode: añade color-scheme más variables con light-dark() esta misma tarde. Es una hora de trabajo con mejora de experiencia inmediata para todos los usuarios con sistema oscuro activado.

Si tienes dark mode con muchos selectores duplicados: refactoriza a light-dark(). Vas a borrar la mitad de tu CSS de un plumazo.

Si quieres ofrecer un toggle manual: tres estados (claro, oscuro, sistema) con localStorage. Es la implementación correcta en 2026.

¿Has implementado dark mode en tu web? Cuéntame en los comentarios qué fue lo más difícil.

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Scroll al inicio