chris-ware/bem-twig-extension

Twig function that inserts static classes in BEM methodology.

bem-twig-extension

Twig function that inserts static classes in BEM methodology., _(*1)

Based on [https://github.com/drupal-pattern-lab/bem-twig-extension], but adapted to be available as a normal twig extension, _(*2)

Add Extension

$twig = new Twig_Environment($loader, $options);
$twig->addExtension(new Bem\Twig\BemExtension());

Usage (4 arguments)

Simple block name (required argument):

<h1 {{ bem('title') }}>, _(*3)

This creates:, _(*4)

<h1 class="title">, _(*5)

Block with modifiers (optional array allowing multiple modifiers):

<h1 {{ bem('title', ['small', 'red']) }}>, _(*6)

This creates:, _(*7)

<h1 class="title title--small title--red">, _(*8)

Element with modifiers and blockname (optional):

<h1 {{ bem('title', ['small', 'red'], 'card') }}>, _(*9)

This creates:, _(*10)

<h1 class="card__title card__title--small card__title--red">, _(*11)

Element with blockname, but no modifiers (optional):

<h1 {{ bem('title', '', 'card') }}>, _(*12)

This creates:, _(*13)

<h1 class="card__title">, _(*14)

Element with modifiers, blockname and extra classes (optional - in case you need non-BEM classes):

<h1 {{ bem('title', ['small', 'red'], 'card', ['js-click', 'something-else']) }}>, _(*15)

This creates:, _(*16)

<h1 class="card__title card__title--small card__title--red js-click something-else">, _(*17)

Element with extra classes only (optional):

<h1 {{ bem('title', '', '', ['js-click']) }}>, _(*18)

This creates:, _(*19)

<h1 class="title js-click">, _(*20)