Forked version of classnames to support inline styles generated from a group of objects and "class" names (really just root-level keys on the objects)
- classStyles can be bound to an object or an array of objects. These objects
should have a
{ key: styleObject, otherKey: otherStyle }
structure. - Arguments are applied from left to right, overwriting defined styles as they are applied.
- String arguments are split by space (
" "
) and are applied in turn. - Object arguments are applied as raw style objects.
- Arrays are recursed into, applying these rules to Strings, Objects and Arrays as they're encountered.
- Property values of
undefined
,null
,""
,true
orfalse
are not applied and will skip overwriting previously encountered properties.{ heading: { fontSize: "12pt" } }
followed by{ heading: { fontSize: null, color: "black" } }
will result in{ heading: { fontSize: "12pt", color: "black" } }
import classStyles from 'class-styles'
// Define style objects
const markupStyles = { container: { backgroundColor: 'white', margin: '0px auto' } },
otherStyles = { container: { color: 'red' }, outer: { margin: '10px' } }
// Bind style objects to classStyles. Can be either an object, or an array of objects.
const cx = classStyles.bind([ markupStyles, otherStyles ])
cx('container outer')
// => { margin: '10px', backgroundColor: 'white', color: 'red' }
cx('container', { paddingBottom: '5px' })
// => { backgroundColor: 'white', margin: '0px auto', paddingBottom: '5px' }
cx({ padding: '10px' }, 'not-exist')
// => { padding: '10px' }
// or, without using .bind
classStyles.call([ markupStyles, otherStyles ], 'outer')
// => { margin: '10px' }
npm install class-styles --save
Alternatively, you can simply include index.js
on your page with a standalone
<script>
tag and it will export a global classStyles
method, or define the
module if you are using RequireJS.
class-styles
follows the SemVer standard for versioning.
There is also a Changelog.
Array.isArray
: see MDN for details about unsupported older browsers (e.g. <= IE8) and a simple polyfill.
MIT. Copyright (c) 2016 Jed Watson, Tom McKenzie.