Тёмный режим в Tailwind CSS
Тёмный режим — это распространённая тенденция в дизайне пользовательских интерфейсов, которая предлагает интерфейс с тёмными тонами, чтобы снизить усталость глаз и при этом сэкономить заряд батареи устройства.
Tailwind CSS поддерживает функциональность тёмного режима, позволяя разработчикам легко создавать тёмные версии сайтов, адаптированные к системным предпочтениям пользователей.
Tailwind CSS предоставляет модификатор под названиемdark, который позволяет определять стили для тёмного режима.
Когда устройство или операционная система пользователя настроены на тёмный режим, стили с модификаторомdark:будут автоматически применяться.
В следующем примере стили задаются на основе медиазапроса системных предпочтений:
Пример
Этот текст меняется в зависимости от цветового режима.
</div>
Попробуйте »
В светлом режиме:Цвет фона — белый (bg-white), а цвет текста — чёрный (text-black)。
В тёмном режиме:Цвет фона — чёрный (dark:bg-black), а цвет текста — белый (dark:text-white)。
Включение тёмного режима
По умолчанию Tailwind использует стратегию media для определения тёмного режима, которая основана на системных предпочтениях пользователя.
Если вам нужен более тонкий контроль, вы также можете использовать стратегию class.
1. Включение тёмного режима в tailwind.config.js
Пример
darkMode: 'media', // В зависимости от системных настроек (по умолчанию)
// darkMode: 'class', // Ручное переключение на основе имени класса
theme: {
extend: {},
},
plugins: [],
}
mediaРежим: На основе настроек операционной системы пользователя (через медиазапросprefers-color-scheme: dark) он переключается автоматически.classРежим: Позволяет разработчикамhtmlилиbodyдобавить к тегуdarkclass, чтобы вручную переключать тёмный режим.
Различия между двумя режимами:
| Mode | Способ определения | Способ управления | Сценарий использования |
|---|---|---|---|
mediaMode | Медиазапрос на основе системных настроек | Автоматическое переключение | Простые сценарии использования, пользовательская логика не требуется |
classMode | Основано на ручномhtmlилиbodyдобавлении вdarkКласс | Пользовательская логика переключения от разработчика | Сложные сценарии, требующие кнопок или переключателей |
Пример логики переключения (режим класса)
Чтобы поддерживать ручное переключение тёмного режима вместо того, чтобы полагаться на предпочтения операционной системы, используйте стратегию class вместо стратегии media.
Теперь класс dark:{class} больше не будет работать на основе prefers-color-scheme, а вместо этого вступит в силу, когда класс dark появится в дереве 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>
Пример
<script>
const toggle = document.getElementById('toggle-dark-mode');
toggle.addEventListener('click', () => {
document.documentElement.classList.toggle('dark');
});
</script>
Попробуйте »
Как использовать утилитарные классы тёмного режима
1. Переключение стилей
Используйтеdark:префикс, чтобы задать стили для тёмного режима.
Пример
Дизайн, который адаптируется к светлому и тёмному режимам.
</div>
Попробуйте »
2. Сочетание адаптивности с тёмным режимом
Адаптивные контрольные точки и тёмный режим можно использовать вместе:
Пример
Адаптивный текст, поддерживающий тёмный режим.
</div>
Попробуйте »
На маленьких экранах размер шрифта — xl.
В тёмном режиме цвет шрифта на маленьких экранах становится светло-серым.
3. Комбинирование интерактивных состояний с темным режимом
Вы можете комбинировать такие состояния, как hover, focus, и т. д., с темным режимом, чтобы применять стили:
Пример
Интерактивная кнопка
</button>
Попробуйте »
Расширение темного режима
В некоторых случаях может потребоваться указать дополнительные цвета или стили для темного режима; это можно сделать, настроив конфигурацию Tailwind с помощью theme.extend.
module.exports = {
theme: {
extend: {
colors: {
brand: {
DEFAULT: '#1DA1F2',
dark: '#0D74B8',
},
},
},
},
}Использование расширенных цветов в HTML:
Пример
Пользовательские цвета темного режима!
</div>
Попробуйте »
Пример
Вот полный пример реализации переключателя темного режима:
Пример
<h1>Добро пожаловать в темный режим</h1>
<button id="toggle-dark-mode" class="mt-4 bg-gray-200 dark:bg-gray-700 text-black dark:text-white p-2 rounded">
Переключить режим
</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>
Попробуйте »