https://github.com/fallaciousreasoning/postcss-plugin-darkmode
PostCSS plugin for an @darkmode AtRule
https://github.com/fallaciousreasoning/postcss-plugin-darkmode
Last synced: about 2 months ago
JSON representation
PostCSS plugin for an @darkmode AtRule
- Host: GitHub
- URL: https://github.com/fallaciousreasoning/postcss-plugin-darkmode
- Owner: fallaciousreasoning
- License: mit
- Created: 2022-09-01T00:00:47.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-09-12T00:12:14.000Z (almost 4 years ago)
- Last Synced: 2025-02-14T11:40:50.318Z (over 1 year ago)
- Language: JavaScript
- Size: 115 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# postcss-plugin-darkmode
[PostCSS] plugin for an @darkmode AtRule.
[PostCSS]: https://github.com/postcss/postcss
The plugin allows you to toggle light and dark mode at different levels of the
DOM, without requiring any JavaScript at all! It works by extracting properties
used in Light & Dark mode into CSS variables.
```html
```
## Examples
### CSS
```css
.foo {
padding: 12px;
background: pink;
display: flex;
flex-direction: column;
}
@darkmode {
.foo {
background: red;
flex-direction: row;
}
}
```
```css
:root, [data-theme=light] {
--\.foo_background: pink;
--\.foo_flex-direction: column;
}
[data-theme=dark] {
--\.foo_background: red;
--\.foo_flex-direction: row;
}
@media (prefers-color-scheme: dark) {
:root {
--\.foo_background: red;
--\.foo_flex-direction: row;
}
}
.foo {
padding: 12px;
display: flex;
background: var(--\.foo_background);
flex-direction: var(--\.foo_flex-direction);
}
```
### Sass
```sass
.foo {
padding: 12px;
background: pink;
display: flex;
flex-direction: column;
@darkmode {
background: red;
flex-direction: row;
}
}
```
```css
:root, [data-theme=light] {
--\.foo_background: pink;
--\.foo_flex-direction: column;
}
[data-theme=dark] {
--\.foo_background: red;
--\.foo_flex-direction: row;
}
@media (prefers-color-scheme: dark) {
:root {
--\.foo_background: red;
--\.foo_flex-direction: row;
}
}
.foo {
padding: 12px;
display: flex;
background: var(--\.foo_background);
flex-direction: var(--\.foo_flex-direction);
}
```
## Options
| | Default | Description | Example Alternative
| -------------- | ------- | ----------- | ------
| Light Selector | `[data-theme=light]` | Used to select an elements with light mode forced | `.light`
| Dark Selector | `[data-theme=dark]` | Used to select elements with dark mode forced. | `.dark`
## Usage
**Step 1:** Install plugin:
```sh
npm install --save-dev postcss postcss-plugin-darkmode
```
**Step 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:
```diff
module.exports = {
plugins: [
+ require('postcss-plugin-darkmode'),
require('autoprefixer')
]
}
```
[official docs]: https://github.com/postcss/postcss#usage