2.0.0 • Published 4 years ago

react-js2css-theme v2.0.0

Weekly downloads
5
License
ISC
Repository
github
Last release
4 years ago

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.

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

  • 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
const yourTheme = {
  background: 'black',
  textColor: 'white',
  fontFamily: '"Roboto", sans-serif',
  fontWeight: 500,
  button: {
    padding: '10px',
  },
};
import JSToCSSTheme from 'react-js2css-theme';

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

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 :)

  • All browsers except IE
2.0.0

4 years ago

1.1.2

4 years ago

1.1.1

4 years ago

1.1.0

4 years ago

1.0.4

4 years ago

1.0.2

4 years ago

1.0.3

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago