babel-plugin-style-literal
v0.0.3
Published
A Babel plugin that compiles tagged css string to JSX inline styles
Downloads
6
Readme
Babel Plugin Style Literal
This is an experimental plugin that compiles tagged string literals to inline style objects that can be used in JSX components. No runtime needed.
Rationale
This is not a "CSS-in-JS" approach and is not supposed to be one. Even though I heavily use CSS, often I find inline styles useful when prototyping or making data visualization piece which styles are not just presentation aspects, but the content itself.
However, there is some friction present when you need to work with inline styles in JSX. It requires style to be written as an object, with keys camelCased. So when you have some CSS you can copy-paste, you need to do some work to make it look like an object. This is quite unproductive piece of work. And later, when you decide to move those inline styles to a CSS file, an opposite amount of work has to be done.
This plugin aims at removing that unnecessary friction and unlocking complete experience in writing CSS code no matter where you need it.
Usage
- Install the plugin
npm install --save-dev babel-plugin-style-literal
- Add the plugin to your Babel config
{
"plugins": ["babel-plugin-style-literal"]
}
In your code, use css
as a template tag whenever you need to compile a piece
of CSS to object literal. You don't need to import the tag, the plugin will
remove it in the build time.
Examples
In:
let textColor = getRandomColor();
let style = css`
font-size: 12px;
line-height: 1.5;
color: ${textColor};
`;
let text = <p style={style}>Hello, World!</p>;
Out:
let textColor = getRandomColor();
let style = {
fontSize: '12px',
lineHeight: '1.5',
color: textColor,
};
let text = <p style={style}>Hello, World!</p>;
License
MIT License.