CSS / HTML / Intermedio / 3 min
Dark Mode toggle solo con CSS
Toggle de modo oscuro con CSS custom properties, :has() y prefers-color-scheme, sin JavaScript.
Este patrón implementa dark mode sin JavaScript usando :has(), CSS custom properties y prefers-color-scheme.
El estado vive en un checkbox oculto y el diseño consume variables globales. Funciona en HTML puro, WordPress, React o Next.js cuando el toggle está dentro del árbol que quieres afectar.
Guía de Implementación Paso a Paso
- Pega el CSS en tu hoja global o dentro del
<head>. - Añade el HTML del toggle en el header o navbar.
- Reemplaza los tokens de color con los de tu marca.
- Verifica el modo del sistema desde DevTools.
- Si necesitas persistencia entre visitas, complementa este patrón con JavaScript y
localStorage.
HTML
<input type="checkbox" id="dark-toggle" class="kf-dark-toggle-input" aria-label="Activar modo oscuro">
<label for="dark-toggle" class="kf-dark-toggle-btn" aria-hidden="true" title="Cambiar modo">
<span class="kf-sun">☀️</span>
<span class="kf-moon">🌙</span>
</label>
<style>
:root {
--bg-primary: #ffffff;
--bg-secondary: #f8f9fa;
--bg-card: #ffffff;
--text-primary: #1a1a2e;
--text-secondary: #64748b;
--text-muted: #94a3b8;
--border: #e2e8f0;
--accent: #3b82f6;
--accent-hover: #2563eb;
--shadow: rgba(0, 0, 0, 0.1);
--code-bg: #f1f5f9;
--transition: color 0.3s ease, background-color 0.3s ease, border-color 0.3s ease;
}
:root:has(#dark-toggle:checked),
.dark-mode {
--bg-primary: #0f172a;
--bg-secondary: #1e293b;
--bg-card: #1e293b;
--text-primary: #f1f5f9;
--text-secondary: #94a3b8;
--text-muted: #64748b;
--border: #334155;
--accent: #60a5fa;
--accent-hover: #93c5fd;
--shadow: rgba(0, 0, 0, 0.5);
--code-bg: #0f172a;
}
@media (prefers-color-scheme: dark) {
:root:not(:has(#dark-toggle)) {
--bg-primary: #0f172a;
--bg-secondary: #1e293b;
--bg-card: #1e293b;
--text-primary: #f1f5f9;
--text-secondary: #94a3b8;
--text-muted: #64748b;
--border: #334155;
--accent: #60a5fa;
--accent-hover: #93c5fd;
--shadow: rgba(0, 0, 0, 0.5);
--code-bg: #0f172a;
}
}
body {
background-color: var(--bg-primary);
color: var(--text-primary);
transition: var(--transition);
}
.kf-dark-toggle-input {
position: absolute;
opacity: 0;
width: 0;
height: 0;
pointer-events: none;
}
.kf-dark-toggle-btn {
display: inline-flex;
align-items: center;
justify-content: center;
width: 44px;
height: 44px;
border-radius: 50%;
cursor: pointer;
background: var(--bg-secondary);
border: 1px solid var(--border);
transition: var(--transition);
font-size: 20px;
user-select: none;
}
.kf-dark-toggle-btn:hover {
background: var(--border);
}
.kf-sun {
display: none;
}
.kf-moon {
display: inline;
}
:root:has(#dark-toggle:checked) .kf-sun {
display: inline;
}
:root:has(#dark-toggle:checked) .kf-moon {
display: none;
}
h1, h2, h3, h4, h5, h6 {
color: var(--text-primary);
transition: var(--transition);
}
p, li, span {
color: var(--text-secondary);
transition: var(--transition);
}
a {
color: var(--accent);
transition: var(--transition);
}
a:hover {
color: var(--accent-hover);
}
.card, .box, article {
background: var(--bg-card);
border: 1px solid var(--border);
box-shadow: 0 2px 8px var(--shadow);
transition: var(--transition);
}
code, pre {
background: var(--code-bg);
color: var(--text-primary);
border: 1px solid var(--border);
transition: var(--transition);
}
input, textarea, select {
background: var(--bg-secondary);
color: var(--text-primary);
border: 1px solid var(--border);
transition: var(--transition);
}
</style>
Prompt para Codex
TEXT
Crea un sistema completo de Dark Mode usando solo CSS custom properties y el selector :has() — sin JavaScript ni localStorage.
Requisitos técnicos:
- Usa <input type="checkbox" id="dark-toggle"> oculto como state manager
- Define CSS custom properties en :root para modo claro: --bg-primary, --bg-secondary, --bg-card, --text-primary, --text-secondary, --text-muted, --border, --accent, --accent-hover, --shadow, --code-bg, --transition
- Define las mismas variables para modo oscuro en :root:has(#dark-toggle:checked)
- Incluye @media (prefers-color-scheme: dark) para respetar la preferencia del SO cuando no hay toggle activo
- Botón toggle con <label for="dark-toggle"> que muestre ☀️ en oscuro y 🌙 en claro usando :has()
- Aplica las variables a: body, h1-h6, p/li/span, a, .card/.box/article, code/pre, input/textarea/select
- Transición suave de 0.3s en color y background-color
- Colores para claro: blanco y gris claro. Para oscuro: #0f172a y #1e293b
Salida: bloque HTML del toggle + bloque <style> completo listo para pegar en cualquier sitio.