css-template

convert css string to style object. Useful for inline styling in React

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
css-template
3310.2.36 years ago7 years agoMinified + gzip package size for css-template in KB

Readme

css-template
Reduce context-switching when defining style in React Component.
To use inline styles in React, you often find yourself writing this type of code:
const styles = {
  title: {
    borderBottomLeftRadius: '10px',
    //    ^     ^   ^       ^    ^^
    //    |     |   |       |    ||___ annoying trailing comma
    //    |     |   |       |____|____ annoying JS quotes
    //    |_____|___|_________________ annoying camel case
    //
    //    (╯°□°)╯︵ ┻━┻ I WANT CSS BACK!!!
  }
}

With css-template, those times are gone! Instead of writing this:
// THIS IS BAD FOR YOUR EYES
const styles = {
  title: {
    marginTop: '10px',
    fontSize: '120%',
    lineHeight: '1.5',
    textAlign: 'center',
    backgroundColor: 'rgba(100, 255, 100, 0.7)',
  },
  footer: {
    width: 'calc(100% - 16px)',
    textAlign: 'right',
    marginTop: '20px',
  }
};

you can write something like this
// THIS IS BETTER
const styles = {
  title: css`{
    margin-top: 10px;
    font-size: 120%;
    line-height: 1.5;
    text-align: center;
    background-color: rgba(100, 255, 100, 0.7);
  }`,
  footer: css`{
    width: calc(100% - 16px);
    text-align: right;
    margin-top: 20px;
  }`,
};
Supported Features
  • translate snake-case to camelCase

```js
css`margin-top: 20px` // will be translated to { marginTop: '20px' }
```
  • multiple lines with optional brackets for better visuals

```js
css`{
  padding: 10px;
  margin: 10px;
}`

// is equivalent to
css`
  padding: 10px;
  margin: 10px;
`
```
  • optional final semicolon

```js
css`padding: 10px`

// is equivalent to
css`padding: 10px;`
```
  • multiple rules in one line

```js
css`padding: 10px; margin: 10px`
```
  • compose other style objects

```js
const bigFont = css`font-size: 200%`
const underlined = css`text-decoration: underline`

const myStyle = css`{
  composes: ${bigFont};
  composes: ${underlined};
  padding: 10px;
  margin: 10px;
}`
```
Installation
npm i -S css-template
Usages
import css from 'css-template';

const COLOR_MAIN = 'white';
const BACKGROUND_MAIN = '#336699';
const awesomeStyles = css`font-size: 200%`;

const styles = {
  header: css`{
    padding: 10px 0 20px 10px;
    text-align: center;
  }`,
  main: css`{
    composes: ${awesomeStyles};
    color: ${COLOR_MAIN};
    background-color: ${BACKGROUND_MAIN};
  }`
};

const MyComponent = (props) => (
  <div>
    <div style={styles.header}>
      {props.header}
    </div>
    <div style={styles.main}>
      {props.main}
    </div>
  </div>
);
ROADMAP
  • x composes: ${otherStyles}; just like postcss composes feature
  • optional auto-prefixer
  • spread numeric values like padding: ${[10, 20, 0, 10]}px;