unique-classnames

A simple utility for conditionally joining classNames together, all classNames won't be duplicated.


Keywords
css, classes, classname, classnames, unique, util, utility, react
License
MIT
Install
npm install unique-classnames@1.0.2

Documentation

Unique-Classnames

English | 简体中文

A simple javascript utility for conditionally joining classNames together, and none of the classNames are duplicated.

Install with npm or Yarn:

npm:

npm install unique-classnames --save

yarn

yarn add unique-classnames

Usage

The arguments can be string, number, array and object.

string:

const classnames = require('unique-classnames');
classnames('foo bar', 'foo2 bar2'); // => 'foo bar foo2 bar2'
classnames('foo bar', 'foo bar2'); // => 'foo bar bar2'

number:

const classnames = require('unique-classnames');
classnames(1, 2, 3); // => '1 2 3'
classnames(1, 2, 2, 2, 3, 3); // => '1 2 3'

array:

const classnames = require('unique-classnames');
classnames([1, 2, 'foo', 'bar']); // => '1 2 foo bar'
classnames([1, 2, 'foo', 'bar'], ['foo', 1, 2]); // => '1 2 foo bar'

object:

const classnames = require('unique-classnames');
classnames({foo: true, 'bar': true}); // => 'foo bar'
classnames({foo: true, 'bar': false}); // => 'foo'

classnames({foo: 1, 'bar': 1}); // => 'foo bar'
classnames({foo: 0, 'bar': 1}); // => 'bar'

classnames({'foo bar': true}); // => 'foo bar'
classnames({'foo bar': true}, {bar: false}); // => 'foo'
classnames({'foo bar': true}, {foo: false}, 'foo'); // => 'foo bar'

All types can be combined with each others. And if there are more than one 'className' with the same name, and the last one will cover the front one. For example:

classnames({'foo bar': true}, {foo: false}, 'foo'); // => 'foo bar'

The 'foo' of {foo: false} will cover the one in 'foo bar' of {'foo bar': true}, but it will be covered by the last argument 'foo', so the result is {foo: true, bar: true} => 'foo bar'