README.md

January 15, 2017 ยท View on GitHub

CSS constructor for React

ย 

Every React component gets an inbuilt javascript constructor for functional logic.

Introducing the css constructor for styling!

ย  ย 

import React from 'react';
import css from 'css-constructor';                  // ๐Ÿ‘ถ Super tiny: only 1.2K gzipped!

export default class Hello extends React.Component {

    /* javascript constructor */
    constructor (props) {
        super(props);
    }

    /* css constructor */                           
    @css`                                           // ๐Ÿ”’ Isolated and co-located
        font-size: 16px;                            
        text-align: center;                         // ๐ŸŽ€ Supports the entirety of CSS

        color: {this.props.color};                  // ๐Ÿ”ฅ Use props in css

        display: flex;                              // ๐Ÿ’ป Built in vendor prefixing

        &:hover {                                   // ๐ŸŒ€ Pseudo selectors
            color: #FFF;
        }

        img {                                       // ๐Ÿ‘ช Nested css
            border-radius: 50%;
        }
        #handle {
            margin-top: 20px;
        }

        @media (max-width: 600px) {                 // ๐Ÿ“ฑ Media queries support
            & {font-size: 18px;}
        }
    `

    render () {
        return (<div>                               // ๐Ÿ”ผ Attaches class to the highest element
            <img src="https://github.com/siddharthkp.png"/>
            <div id="handle">@siddharthkp</div>
        </div>)
    }
};

// <Hello color='papayawhip'/>

--

Other features

๐Ÿ™‹ Uses classes instead of inline styles

๐Ÿ”ง Editable in developer tools

๐Ÿ‘ถ Super tiny: only 1.2K gzipped!

๐Ÿ’„ Official library emoji

Coming soon

๐ŸŒ server side rendering

--

Usage

  1. npm install css-constructor --save

  2. import css from 'css-constructor'

  3. Add a @css block just before the render function (important)

  4. Add transform-decorators-legacy as the first plugin in your .babelrc (already downloaded with ๐Ÿ’„).

If you are not familiar with babel plugins you can follow the detailed instructions here.

Or, if you would prefer using ๐Ÿ’„ without adding the babel transform for decorators, up-vote this issue.

--

How does it work?

๐Ÿ’„ uses ES7 class method decorators on the render function. Detailed post coming soon.

Inspiration

Heavily inspired from glamor, styled-components and radium

Special thanks to thysultan. stylis is the bomb!

Support

โญ๏ธ this repo!