Методы модулей

var app = angular.module('myModule', []);

config

app.config(function)

Конфигурирует модуль

app.config(function($routeProvider){
    $routeProvider
        .otherwise({redirectTo: '/'})
});

constant

app.constant(key, value)

Объявляет константу модуля

app.constant('CONST', 123);

controller

app.controller(name, constructor)

Объявляет контроллер в модуле

app.controller(
    'myController',
    function(){
        ...
    }
)

directive

app.directive(name, constructor)

Объявляет директиву в модуле.

Обработчик может вернуть объект со следующими свойствами, или просто какойто обработчик

• compile - метод(либо ссылка на метод) с инструкциями по компиляции шаблона

  Функция компиляции compile (используется довольно редко) трансформирует HTML шаблон.

  Функция принимает следующие аргументы:

  • шаблон элемента

  • шаблон атрибутов

  • связывающая функция

  Функция может возвращать функцию или объект.

• controller - метод (либо ссылка на метод) где описано поведение(логика)

  Необходима в случае, когда логика директивы выходит за пределы одного метода и нам уже необходимма группа методов.

  Такую группу методов мы можем объединить в функцию-контроллер.

  Это будет специальный тип контроллера “связанный с директивой”, которые должен взаимодействать только с данной директивой.

• link - основной параметр фабрики – метод(либо ссылка на метод) по связыванию директивы с приложением

  После компиляции функция линковки link регистрирует обработчики событий на DOM обновленного HTML.

  метод принимает следующие атрибуты:

  • scope

  • element

  • attrs

  • ctrl

  • transclude - функция для трансклуда

    transclude(scope, function(clone, scope){
        // scope - скоуп клинируемого элемента
        // если не хочется использовать transclude: true,
        element.append(clone);
    });
    

• name – имя текущей области видимости (scope).

  Не обязательный и по умолчанию это имя заданное при регистрации директивы.

• priority - приоритет выполнения, для случая когда на одном элементе несколько директив

• replace

  • true – шаблон директивы заменит элемент

  • false – произойдет append

• restrict - задает способ встраивания

  • E - тэг(имя элемента)

  • A - атрибут

  • C - класс

  • M - комментарий

• require - требовать от других контроллеров передавать в текущую директиву связывающую функцию.

• scope - Определяет способ передачи scope в директиву

  В зависимости от типа переданного параметра ведёт себя по разному:

  • true – создается новый scope конкретно для этой директивы

  • {} - задается конкретный изолированный scope – т.е. scope не унаследованный от родительского

    Может влючать в себе ссылки на элементы родительского scope при использоварнии нетривиального синтаксиса (специальный префикс символ (@, =, & ) перед имеем метода/переменой)

    • @ или @attr – связывает переменную локального scope со значением DOM аттрибута

    • = или =attr – двустороннее связывание значения атрибута и переменной

    • & или &attr– позволяет выполнять выражения из аттрибута в рамках родительского scope

  • false - используется scope ближайшего контроллера (default)

• template - шаблон HTML

• templateUrl - ссылка на файл шаблона

• terminal

  • true - текущий приоритет будет установлен на последующие директивы

• transclude - компилирует контент элемента и делает возможные его вставку внутрь шаблона (по средством ngTransclude )

  • true - не потерять содержимое директивы

  • ‘element’

// простая директива
app.directive(
    'pane',
    function(){
        return function(){
            ...
        }
    }
);

// директива с настройками
app.directive(
    'pane',
    function(){
        return {
            restrict: 'E',
            transclude: true,
            scope: {
                title:'@'
            },
            template: '<div style="border: 1px solid black;">' +
                      '<div style="background-color: gray">{{title}}</div>' +
                      '<div ng-transclude></div>' +
                      '</div>',
            link: function(scope, element, attrs, ctrl, transclude){

            }
        };
    };
});

factory

app.factory(name, providerFunction)

Фабрика

app.factory(
    'some_factory',
    function(){
        return {
            some_var: 'some_var_description'
        }
    });

filter

app.filter(name, constructor)

app.filter(
    'first_filter',
    function(){
        return function(value){
            return '2,' + value;
        };
})

name

name

Имя модуля

provider

app.provider(name, constructor)

run

app.run()

app.run(function($rootScope){
    // эта штука иногда перехвататывает ошибки,
    // которые не отображаются в консоли
    $rootScope.$on('$stateChangeError', function(){
        throw arguments[5];
    });
    ...
});

requires

requires

Зависимости модуля

service

service(name, constructor)

value

app.value(key, value)

Объявляет переменную в модуле