1.0.0 • Published 3 years ago

get-bem v1.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
3 years ago

get-bem

A sass library from easily generating BEM methodology style classes

Usage

Import it into your main stylesheet:

@import 'get-bem';

Example

@import 'get-bem.scss';
 
@include block("content") {
    width: 100%;

    @include modifier('hidden') {
        visibility: hidden;
    }

    @include element('body') { 
        display: flex;
        justify-content: center;
        font-size: 1.1rem;

        @include modifier('small') {
            font-size: 1rem;
        }

        @include modifier('tiny') {
            font-size: .75rem;
        }

        @include element('image') { 
            width: 200px;
            height: 200px;
        }
    }

    @include element('footer') {
        border-top: 1px solid initial;
    }
}

The compiled CSS:

.content {
  width: 100%;
}
.content--hidden {
  visibility: hidden;
}
.content__body {
  display: flex;
  justify-content: center;
  font-size: 1.1rem;
}
.content__body--small {
  font-size: 1rem;
}
.content__body--tiny {
  font-size: 0.75rem;
}
.content__body__image {
  width: 200px;
  height: 200px;
}
.content__footer {
  border-top: 1px solid initial;
}

Configs

By default BEM Constructor uses the following BEM convention:

  • Two underscores (__) for elements
  • Two hyphens for modifiers (--).

You can customize them:

    $element-seperator: '_E_'; // Defaults to '__'

    $modifier-seperator: '-M-'; // Defaults to '--'

What the BEM?

BEM (Block, Element, Modifier) is a naming convention methodology that makes your css reusable understandable, easier, scalable. More info