react-classset

Utility for easily manipulating the DOM class string

Usage no npm install needed!

<script type="module">
  import reactClassset from 'https://cdn.skypack.dev/react-classset';
</script>

README

react-classset

classSet() is a neat utility for easily manipulating the DOM class string. This previously resided inside React as a utility, but is now pulled out and library-agnostic.

Here's a common scenario

var classString = 'message';
if (isImportant) {
  classString += ' message-important';
}
if (isRead) {
  classString += ' message-read';
}

This can quickly get tedious, as assigning class name strings can be hard to read and error-prone. classSet() solves this problem:

var classString = classSet({
  'message': true,
  'message-important': isImportant,
  'message-read': isRead
});

When using classSet(), pass an object with keys of the CSS class names you might or might not need. Truthy values will result in the key being a part of the resulting string.

Alternatively, you can also use it this way:

cx('a', 0, null, undefined, 'b'); // 'a 0 b', discards null values

No more hacky string concatenations!