README.ru.md

bem-ng

Библиотека позволяет использовать AngularJS в БЭМ-проектах.

Зависимости

• блоки i-bem и ua из bem-core
• AngularJS Framework
• angular-ui-router

Установка

Самый простой способ с полезными дополнениями это воспользоваться генератором generator-bem для Yeoman. В репозитории имеется подробная инструкция по его установке и использованию. Он позволит вам очень просто создавать сущности и заиметь в бэкенд для тестирования полноценное NodeJS приложение.

Другой способ это ручное подключение по подобию с библиотеками bem-bl, bem-core и bem-components. Используя bower-npm-install, установить библиотеку из Git репозитория или Bower регистра.

Добавить в make.js уровни для сборки блоков, после уровней bem-bl или bem-core:

[ 'libs/bem-ng/common.blocks', 'libs/bem-ng/libs.blocks' ]

Директивы

Написание директив происходит через моду attrs.

{ 
    block: 'alert', 
    attrs: { 'ng-show': 'form.$valid' } 
}

Описание шаблонов

Для создания шаблонов используется блок ng-template, который позволяет собирать куски BEMJSON без обертки в виде блока page.

({ 
    block: 'ng-template', 
    content: [ 
        'Awesome AngularJS template' 
    ] 
})

Отоборажение шаблонов

Вставка шаблонов происходит посредством блока ng-view, который позволяет вставлять шаблоны в единственном и во множественном числе, цепляясь за состояния.

Один шаблон на странице:

{ block: 'ng-view' }

Два шаблона на странице:

{ block: 'ng-view', template: 'contacts' },
{ block: 'ng-view', template: 'copyright' }

Сборка

Скелет, шаблоны, CSS и JavaScript код внешних библиотек собирается с помощью bem-tools.

Авторы

• Виноградов Антон (verybigman)

Предложения

Все замечания и предложения пишите в issue на Github.

MIT License