gb
gulp-bem
npm i gulp-bem
gb

gulp-bem

BEM toolset for gulp

by Vsevolod Strukchinsky

1.0.2 (see all)License:MITTypeScript:Not Found
npm i gulp-bem
Readme

gulp-bem

NPM version Build Status Coverage Status Dependency Status

This package provides simple and clear tools to build your BEM project with simple deps.js support. In fact - gulp can build BEM projects without deps with no additional plugins, read about it on getbem.com — Building.

Usage

Building CSS for BEM project:

var gulp    = require('gulp');
var bem     = require('gulp-bem');
var concat  = require('gulp-concat');

var levels = ['base', 'blocks'];
var tree = bem(levels);

tree.deps('blocks/page')
    .pipe(bem.src('{bem}.css'))
    .pipe(concat('index.css'))
    .pipe(gulp.dest('./dist'));

Pretty easy, eh, mate?

Take a look at getbem.com as example of full-featured web site created with BEM and gulp-bem-stub as starting template for projects!

API

bem(levels, [options])

Creates function, that used for resolving dependencies in BEM project. Returns deps function.

levels

Type: Array or String
Default: process.cwd()

Contains array of Levels. They will be used in searching for requested blocks and ordering blocks with same names in different levels.

options

Type: Object

Options, that passed to bem-naming.

bem.src(glob)

This method consumes stream of BEM objects and searches files by glob pattern in them.

All files, that contained under BEM object path, following some convention about naming. Often CSS file have name of block and added .css suffix. If BEM object describes block with modificators, then it can be block_mod_value.css. You can read about naming and directory structure at getbem.com, if there are questions about it.

glob

Type: String or Array

Same as in gulp.src method, but with some interpolation happening. To provide BEM name generation - bem.src will substitute (with supplant syntax) all properties in BEM object.

Questions

Gitter chat

License

MIT (c) 2014 Vsevolod Strukchinsky

Downloads/wk

5

GitHub Stars

26

LAST COMMIT

7yrs ago

MAINTAINERS

1

CONTRIBUTORS

3

OPEN ISSUES

1

OPEN PRs

1
VersionTagPublished
1.0.2
latest
7yrs ago
1.0.0-alpha-2
1.0.0-alpha-2
8yrs ago
1.0.0-alpha-1
1.0.0-alpha-1
8yrs ago
No alternatives found
No tutorials found
Add a tutorial
No dependencies found

Rate & Review

100
No reviews found
Be the first to rate