README

React CSS Theming (with JS objects)

This tiny 500byte (not gzipped) component allows JS theme objects to be passed into your component where they're converted into CSS Variables for internal use.

Demo

https://codesandbox.io/s/react-js2css-theme-demo-s6xlx

Why?

Switching CSS Variables for themes is unpleasant for users of your component, JS objects are easier to deal with.
CSS Variable changes are much faster than React re-renders via Context which is what CSS-in-JS solutions do.
If you care about performance and bundle size and want to avoid CSS-in-JS solutions altogether you can still provide a nice JS theme object interface to your users.

Install

yarn add react-js2css-theme

Usage

const yourTheme = {
  background: 'black',
  textColor: 'white',
  fontFamily: '"Roboto", sans-serif',
  fontWeight: 500,
  button: {
    padding: '10px',
  },
};

As a component

import JSToCSSTheme from 'react-js2css-theme';

<JSToCSSTheme namespace="xx" theme={yourTheme}>
  <YourComponent />
</JSToCSSTheme>;

As a hook

You may not wish to create an extra wrapping element, in this case you can use the hook:

import { useJsToCss } from 'react-js2css-theme';

function YourComponent() {
  const themeStyle = useJsToCss('xx', yourTheme);

  return (
    <div>
      <style>{themeStyle}</style>
      {/* ... your component JSX */}
    </div>
  );
}

Your component can now make use of the following CSS Variables:

:root {
  --xx-background: black;
  --xx-textColor: white;
  --xx-fontFamily: 'Roboto', sans-serif;
  --xx-fontWeight: 500;
  --xx-buttonPadding: 10px;
}

Now try changing the theme object and watch your component's theme change :)

Requirements

All browsers except IE

Usage no npm install needed!