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
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
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:
| Modo | Método de detección | Método de control | Escenario de uso |
|---|---|---|---|
mediaModo | Consulta de medios basada en las preferencias del sistema | Cambio automático | Escenarios de aplicación simples, sin lógica personalizada |
classModo | Basado en la adición manualhtmlobodyendarkClase | la 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
<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
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
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
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
¡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
<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 »