babel-plugin-template-css-demitasse
v3.2.0
Published
Reduces CSS embedded in template literals to an efficient format used by Demitasse.
Downloads
3
Maintainers
Readme
☕ Demitasse Babel Plugin
This Babel plugin converts CSS code embedded within a template literal to a compact format that Demitasse can use to produce CSS bindings. Simply tag the template literal with a leading /* css */
comment to activate the plugin.
Use this plugin in your production build to remove unused CSS code (e.g. large declaration blocks) since Demitasse only needs the class names and IDs to produce CSS bindings.
Note This is an aggressive optimization and assumes you are following our recommended approach of build-time CSS extraction. For more information, see our guides and examples.
Example
Input
const css = /*css*/`
.container {
height: 100%;
}
#header_nav {
width: 100%;
}
`;
Output
const css = /*css*/`/*extracted*/ .container #header_nav`;
Configuration
The plugin doesn't require any configuration in itself. Your .babelrc
file can be as simple as this:
.babelrc
{ "plugins": ["babel-plugin-template-css-demitasse"] }
Due to Babel's first-to-last plugin ordering, this plugin should be placed at or near the beginning of the list of plugins so that it runs before template literals are transformed by another plugin.
See also
For a less aggressive optimization, see babel-plugin-template-css-minifier. This plugin simply minifies the CSS, otherwise leaving declaration blocks, media queries, and other CSS statements intact. This may be useful in some scenarios, such as:
- Needing a
css
export to remain useful at runtime for some purpose other than generating CSS bindings - Adding component CSS to the document explicitly at runtime