reactcss-extra

ReactCSS with a few extra features

Usage no npm install needed!

<script type="module">
  import reactcssExtra from 'https://cdn.skypack.dev/reactcss-extra';
</script>

README

reactcss-extra

NPM JavaScript Style Guide

ReactCSS with some extra features

Original ReactCSS

The original version of ReactCSS by casesandberg can be found here (github)

What's changed

  • The use of lodash has changed. Now only the necessary lodash sub-modules are imported instead of the entire lodash module.

  • Added a new function styleMerge which allows for combining multiple ReactCSS styles (can provide any number of styles):

const divColours = reactCSSExtra({
    "default": {
        div: {
            color: "red",
        },
    },
});

const divFontSize = reactCSSExtra({
    "default": {
        div: {
            fontSize: "48px",
        },
    },
});

const combined = styleMerge(false, divColours, divFontSize);
//---------------
/*
* {
*   div: {
*     color: "red",
*     fontSize: "48px"
*   }
* }
*/

const combinedWithoutDivKey = styleMerge(true, divColours, divFontSize);
//---------------
/*
* {
*   color: "red",
*   fontSize: "48px"
* }
*/
  • The type definition for reactCSS was changed to allow for keys to be left out of activating classes (and to allow for styles to be left out, too)
const styles = reactCSSExtra({
    "default": {
        div1: {
            fontWeight: "200",
            fontSize: "30px",
        },
        div2: {
            fontWeight: "400",
        }
    },
    "heavy": {
        div1: {
            fontWeight: "400",
            //fontSize doesn't need to be specified again, it will just inherit "30px" from above
        },
        //div2 doesn't need to be specified again, it will just inherit from above
    }
}, {
    "heavy": true,
});
//---------------
/*
* {
*   div1: {
*      fontWeight: "400"
*      fontSize: "30px",
*   },
*   div2: {
*      fontWeight: "400",
*   }
* }
*/
  • reactCSS became reactCSSExtra

Change log

Version 1.2.6

  • Fixed more issues that I don't find because I don't test properly

Version 1.2.5

  • Fixed issue to do with extra scopes

Version 1.2.4

  • Small issue that I fixed when changing the styleMerge typings (when destroyTopLevelKeys was true) I also fixed when destroyTopLevelKeys was false NOTE: For instance when D = styleMerge(false, X, Y), D will inherit keys from X, so just be careful!

Version 1.2.3

  • I always leave stuff out when doing tests and I never put it back, so I put that stuff back

Version 1.2.2

  • Improved the styleMerge typings. Made them more optimised and fixed? it even though I don't know whether it was actually broken.

Version 1.2.1

  • Corrected name

Version 1.2.0

  • Added proper typings for the styleMerge function. It no longer just returns object but actually the combined objects provided. It also removed the keys if you specify, but it's pretty unoptimised.
  • Fixed typings for reactCSSExtra. An attribute like position that used the type "absolute" | "relative" | ... rather than just string would error because string is not assignable to type "absolute" | "relative" | ....