bemcn

bemcn is an utility for creating BEM class names.

Explanation

var bc = bemcn('__', '--');

bc('b')()()             // b
bc('b')()('m')          // b--m
bc('b')()('m', true)    // b b--m
bc('b')('e')()          // b__e
bc('b')('e')('m')       // b__e--m
bc('b')('e')('m', true) // b__e b__e--m

var bc = bemcn('__', '--', true);

bc('b')()()              // b
bc('b')()('m', false)    // b--m
bc('b')()('m')           // b b--m
bc('b')('e')()           // b__e
bc('b')('e')('m', false) // b__e--m
bc('b')('e')('m')        // b__e b__e--m

Install

$ npm install --save bemcn

Usage

Browser

<script src="path/to/bemcn.js"></script>
<script>
    var bcn = bemcn('__', '--');
    bcn('block')('element')('modifier');
</script>

AMD

requirejs(['path/to/bemcn'], function(bemcn) {
    var bcn = bemcn('__', '--');
    bcn('block')('element')('modifier');
});

Node.js

var bemcn = require('bemcn');
var bcn = bemcn('__', '--');
bcn('block')('element')('modifier');

Functions

bemcn(ep, mp, [wbd]) ⇒ b

BEM class names

b(v) ⇒ e

block creator

e([v]) ⇒ m

element creator

m([v], [wb]) ⇒ string

modifier and result creator

bemcn(ep, mp, [wbd]) ⇒ b

BEM class names

Kind: global function
Returns: b - - block creator

Param	Type	Description
ep	string	element prefix
mp	string	modifier prefix
[wbd]	boolean	with base class name (default value)

b(v) ⇒ e

block creator

Kind: global function
Returns: e - - element creator

Param	Type	Description
v	string	block name

e([v]) ⇒ m

element creator

Kind: global function
Returns: m - - modifier and result creator

Param	Type	Description
[v]	string	element name

m([v], [wb]) ⇒ string

modifier and result creator

Kind: global function
Returns: string - - result

Param	Type	Description
[v]	string	modifier name
[wb]	boolean	with base class name (default wbd)

Example

var bcn = bemcn('__', '--', true);
var form = bcn('form');
var field = form('field');
var label = form('label');

form()('inline') // form form--inline
field()          // form__field
field('error')   // form__field form__field--error
label()          // form__label
label('hidden')  // form__label form__label--hidden

Note on Patches/Pull Requests

1. Fork the project.
2. Make your feature addition or bug fix.
3. Send me a pull request.

---

© 2017 Vasily Shilov