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#0f1115o 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
currentColorpara 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
- Añade
color-schemey las variables conlight-dark()en el CSS adicional del tema (Personalizar → CSS adicional, o el archivo de tu tema hijo). - Coloca un toggle en el header con tres botones (claro, oscuro, sistema).
- Inserta el JavaScript mÃnimo con
wp_enqueue_scriptdesde elfunctions.phpde tu tema hijo, no directamente en el tema padre. - Audita tus imágenes destacadas: las que tengan fondo blanco transparente, sustitúyelas por SVG o duplÃcalas para cada modo.
- 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
- Activa el modo oscuro a nivel de sistema operativo y carga tu web.
- Revisa cada página: ¿el texto es legible?, ¿las imágenes son coherentes?, ¿los formularios se ven bien?
- Mide el contraste en al menos 5 zonas distintas con WAVE.
- Prueba el toggle manualmente: claro, oscuro, sistema. Debe persistir tras recargar la página.
- Visita la web una vez con
prefers-reduced-motionactivado 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
- Cómo usar variables CSS — la base sobre la que se apoya todo este artÃculo.
- Funciones CSS nuevas de 2026 — otras seis novedades que ha ido sumando Chrome este año.
- CSS 2026 sin polyfill — container queries, :has(), View Transitions y más, ya estables sin trucos.
- Diseño web accesible: guÃa práctica y checklist — para revisar el contraste de tu dark mode a fondo.
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.


