/react-bem

Automatic BEM class generator React mixin. Never write a className again.

Primary LanguageJavaScriptBSD 2-Clause "Simplified" LicenseBSD-2-Clause

React BEM Build Status

BEM class names are systematic. So why write them yourself?

Usage

React BEM automatically generates BEM style classes on React components... So you don't have to.

Installation

bower install react-bem

Example

JSX Component:

var Header = React.createClass({
  mixins: [ReactBEM],

  bem_blocks: ["widget"],
  bem_block_modifiers: ["christmas"],

  bem_render: function() {
    return (
      <header className="no-overwrite">
        <h1><span modifiers="blinking">HEADER:</span> This is the Header</h1>
      </header>
    );
  }
});

Translates to:

<header class="no-overwrite widget--christmas__header widget__header" data-reactid=".0">
    <h1 class="widget--christmas__h1 widget__h1" data-reactid=".0.0">
        <span class="widget--christmas__span--blinking widget--christmas__span widget__span--blinking widget__span" data-reactid=".0.0.0"></span>
        <span data-reactid=".0.0.1">
             This is the Header
        </span>
    </h1>
</header>

You can see it live, how it attaches the BEM classes, here.

Custom E

Don't want the E in BEM to be the HTML element name? Don't blame you.

var Header = React.createClass({
  mixins: [ReactBEM],

  bem_blocks: ["widget"],
  bem_block_modifiers: ["christmas"],

  bem_render: function() {
    return (
      <header className="no-overwrite">
        <h1 role="title"><span modifiers="blinking">HEADER:</span> This is the Header</h1>
      </header>
    );
  }
});

Translates to:

<header class="no-overwrite widget--christmas__header widget__header" data-reactid=".0">
    <h1 class="widget--christmas__title widget__title" role="title" data-reactid=".0.0">
        <span class="widget--christmas__span--blinking widget--christmas__span widget__span--blinking widget__span" data-reactid=".0.0.0"></span>
        <span data-reactid=".0.0.1">
             This is the Header
        </span>
    </h1>
</header>

There's a lot of reasons why you should be styling with more than just the class attribute. But say you want to define a role and use something different for your BEM element. Or say you just have a religion about not using the role attribute. Fine.

var Header = React.createClass({
  mixins: [ReactBEM],

  bem_blocks: ["widget"],
  bem_block_modifiers: ["christmas"],

  bem_render: function() {
    return (
      <header className="no-overwrite">
        <h1 role="somerole" bem_element="title"><span modifiers="blinking">HEADER:</span> This is the Header</h1>
      </header>
    );
  }
});

Translates to:

<header class="no-overwrite widget--christmas__header widget__header" data-reactid=".0">
    <h1 class="widget--christmas__title widget__title" role="somerole" data-reactid=".0.0">
        <span class="widget--christmas__span--blinking widget--christmas__span widget__span--blinking widget__span" data-reactid=".0.0.0"></span>
        <span data-reactid=".0.0.1">
             This is the Header
        </span>
    </h1>
</header>

Other Resources

License

React BEM is free--as in BSD. Hack your heart out, hackers.