PostCSS plugin to make switcher to force dark or light theme by copying styles from media query to special class.
@media (prefers-color-scheme: dark) {
:root { /* :root is <html> for HTML documents */
--text-color: white
}
body {
background: black
}
}@media (prefers-color-scheme: dark) {
:root:not(.is-light) { /* :root is <html> for HTML documents */
--text-color: white
}
html:not(.is-light) body {
background: black
}
}
:root.is-dark { /* :root is <html> for HTML documents */
--text-color: white
}
html.is-dark body {
background: black
}By default (without classes on html), website will use browser dark/light
theme. If user want to use dark theme, you set html.is-dark class.
If user want to force light theme, you use html.is-light.
Step 1: Install plugin:
npm install --save-dev postcss postcss-dark-theme-classStep 2: Check you project for existed PostCSS config: postcss.config.js
in the project root, "postcss" section in package.json
or postcss in bundle config.
If you do not use PostCSS, add it according to official docs and set this plugin in settings.
Step 3: Add the plugin to plugins list:
module.exports = {
plugins: [
+ require('postcss-dark-theme-class'),
require('autoprefixer')
]
}Step 4: Add theme switcher to UI. We recommend to have 3 states: light, dark, and auto.
Step 5: Set is-dark and is-light classes to <html> according
to switcher state:
<select name="themeSwitcher" id="themeSwitcher">
<option value="auto">auto</option>
<option value="light">light theme</option>
<option value="dark">dark theme</option>
</select>const html = document.documentElement
const themeSwitcher = document.getElementById('themeSwitcher')
themeSwitcher.addEventListener('change', () => {
if (themeSwitcher.value === 'auto') {
html.classList.remove('is-dark', 'is-light')
} else if (themeSwitcher.value === 'light') {
html.classList.add('is-light')
html.classList.remove('is-dark')
} else if (themeSwitcher.value === 'dark') {
html.classList.add('is-dark')
html.classList.remove('is-light')
}
})module.exports = {
plugins: [
require('postcss-dark-theme-class')({
darkSelector: '.dark-theme',
lightSelector: '.light-theme'
})
]
}Type: string. Default: .is-dark.
Any CSS’s valid selector for <html> (alias for :root), which will switch dark theme.
Use darkSelector: '[data-theme="dark"]' if you will switch theme by setting <html data-theme=dark>
Type: string. Default: .is-light.
Any CSS's valid selector, which will switch light theme.
Use lightSelector: '[data-theme="light"]' if you will switch theme by setting <html data-theme="light">