GitXplorerGitXplorer
a

babel-plugin-style-literal

public
8 stars
0 forks
0 issues

Commits

List of commits on branch master.
Unverified
86247fa77926b530ba97446bd265746445f6edaa

basic syntax error reporting

aalexeyraspopov committed 6 years ago
Unverified
102228dc7080a803ffd129e76762f01a0f28cd6d

whitelist files to publish

aalexeyraspopov committed 6 years ago
Unverified
84fd75f81559d9b3c53f082657929c334b04f73c

version 0.0.2

aalexeyraspopov committed 6 years ago
Unverified
acf466587fdb56e2c60a53751d26780359543cf2

ensure proper transform of prefixed properties

aalexeyraspopov committed 6 years ago
Unverified
745137ad8faf1eb29a0262442c6e8607102cac88

Merge branch 'master' of github.com:alexeyraspopov/babel-plugin-styles-literal

aalexeyraspopov committed 6 years ago
Unverified
239fe59c674ee781d9312f202396e3a78ab3840e

use expressions in README example

aalexeyraspopov committed 6 years ago

README

The README file for this repository.

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

  1. Install the plugin
npm install --save-dev babel-plugin-style-literal
  1. 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.

The implementation is partially based on @blia's css-tag.