Tailwind CSS Dunkelmodus

Der Dunkelmodus ist ein verbreiteter Trend im Design von Benutzeroberflächen, der eine dunkle Oberfläche bietet, um die Augen zu entlasten und gleichzeitig den Akku des Geräts zu schonen.

Tailwind CSS unterstützt die Dunkelmodus-Funktionalität, mit der Entwickler auf einfache Weise dunkle Versionen von Websites erstellen können, die sich an die Systemeinstellungen der Benutzer anpassen.

Tailwind CSS bietet einen Modifikator namensdark, mit dem du Stile für den Dunkelmodus definieren kannst.

Wenn das Gerät oder Betriebssystem des Benutzers auf Dunkelmodus eingestellt ist, werden Stile mit demdark:Modifikator automatisch wirksam.

Das folgende Beispiel legt Stile basierend auf der Medienabfrage für Systemeinstellungen fest:

Beispiel

<div class="bg-white text-black dark:bg-black dark:text-white">
Dieser Text ändert sich je nach Farbmodus.
</div>

Ausprobieren »

Im Hellmodus:Die Hintergrundfarbe ist weiß (bg-white), und die Textfarbe ist schwarz (text-black)。

Im Dunkelmodus:Die Hintergrundfarbe ist schwarz (dark:bg-black), und die Textfarbe ist weiß (dark:text-white)。


Dunkelmodus aktivieren

Standardmäßig verwendet Tailwind die Media-Strategie, um den Dunkelmodus zu erkennen, die auf den Systemeinstellungen des Benutzers basiert.

Wenn du eine feinere Steuerung benötigst, kannst du auch die Klassenstrategie verwenden.

1. Aktivieren des Dunkelmodus in tailwind.config.js

Beispiel

module.exports = {
  darkMode: 'media', // Basierend auf Systemeinstellungen (Standard)
  // darkMode: 'class', // Manuelles Umschalten anhand des Klassennamens
  theme: {
    extend: {},
  },
  plugins: [],
}
  • mediaModus: Basierend auf den Einstellungen des Betriebssystems des Benutzers (über Media Queryprefers-color-scheme: dark) erfolgt die Umschaltung automatisch.
  • classModus: Ermöglicht Entwicklern,htmloderbodydem Tag hinzuzufügendarkclass, um den Dunkelmodus manuell umzuschalten.

Unterschiede zwischen den beiden Modi:

ModeErkennungsmethodeSteuerungsmethodeAnwendungsfall
mediaModeMedia Query basierend auf SystemeinstellungenAutomatisches UmschaltenEinfache Anwendungsfälle, keine benutzerdefinierte Logik erforderlich
classModeBasiert auf manuellemhtmloderbodyHinzufügen zumdarkKlasseBenutzerdefinierte Umschaltlogik durch den EntwicklerKomplexe Szenarien, die Schaltflächen oder Umschalter erfordern

Beispiel für Umschaltlogik (Klassenmodus)

Um das manuelle Umschalten des Dunkelmodus zu unterstützen, anstatt sich auf die Betriebssystemeinstellungen zu verlassen, verwenden Sie die class-Strategie anstelle der media-Strategie.

Nun funktioniert die dark:{class}-Klasse nicht mehr basierend auf prefers-color-scheme, sondern wird stattdessen wirksam, wenn die dark-Klasse im HTML-Baum erscheint:

<!-- 不允许深色模式 -->
<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>

Beispiel

<button id="toggle-dark-mode">Dunkelmodus umschalten</button>
<script>
const toggle = document.getElementById('toggle-dark-mode');
toggle.addEventListener('click', () => {
    document.documentElement.classList.toggle('dark');
});
</script>

Ausprobieren »

Wie man Dark-Mode-Utility-Klassen verwendet

1. Stilwechsel

Verwenden Sie dendark:Präfix, um Stile für den Dark Mode festzulegen.

Beispiel

<div class="bg-gray-200 dark:bg-gray-800 text-gray-900 dark:text-gray-100">
Ein Design, das sich an hellen und dunklen Modi anpasst.
</div>

Ausprobieren »

2. Responsive Design mit Dark Mode kombinieren

Responsive Breakpoints und Dark Mode können zusammen verwendet werden:

Beispiel

<div class="text-lg sm:text-xl dark:text-gray-300 sm:dark:text-gray-500">
Responsiver Text, der den Dark Mode unterstützt.
</div>

Ausprobieren »

Auf kleinen Bildschirmen ist die Schriftgröße xl.

Im Dark Mode wird die Schriftfarbe auf kleinen Bildschirmen hellgrau.

3. Interaktive Zustände mit dem Dark Mode kombinieren

Sie können Zustände wie hover, focus usw. mit dem Dark Mode kombinieren, um Stile anzuwenden:

Beispiel

<button class="bg-white dark:bg-black text-black dark:text-white hover:bg-gray-300 dark:hover:bg-gray-700">
Interaktiver Button
</button>

Ausprobieren »

Dark Mode erweitern

In einigen Fällen müssen Sie möglicherweise zusätzliche Farben oder Stile für den Dark Mode bereitstellen. Dies kann durch Anpassen der Tailwind-Konfiguration über theme.extend erfolgen.

module.exports = {
  theme: {
    extend: {
      colors: {
        brand: {
          DEFAULT: '#1DA1F2',
          dark: '#0D74B8',
        },
      },
    },
  },
}

Erweiterte Farben in HTML verwenden:

Beispiel

<div class="text-brand dark:text-brand-dark">
Benutzerdefinierte Dark-Mode-Farben!
</div>

Ausprobieren »

Beispiel

Hier ist ein vollständiges Beispiel für die Implementierung eines Dark-Mode-Umschalters:

Beispiel

<div class="p-6">
<h1>Willkommen im Dark Mode</h1>
<button id="toggle-dark-mode" class="mt-4 bg-gray-200 dark:bg-gray-700 text-black dark:text-white p-2 rounded">
Modus umschalten
</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>

Ausprobieren »
Andere Erweiterungen