event.Manager
Расширяет IEventManager.
Менеджер событий с распространением. Распространение события происходит в три фазы:
1. Событие получают непосредственные подписчики;
2. Событие получают вышестоящие в иерархии объекты посредством перебрасывания события на родительском менеджере событий;
3. Событие получают обработчики действия по умолчанию посредством служебного события type + 'defaultaction'; действие по умолчанию выполняется, только если поле target события совпадает с контекстом менеджера событий.
Конструктор
event.Manager([options])Параметры:
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| options | — | Тип: Object Опции менеджера событий. |
| options.context | — | Тип: Object Объект, для которого создан менеджер событий. |
| options.controllers | — | Тип: IEventWorkflowController[] Контроллер или контроллеры менеджера событий. |
| options.parent | — | Тип: IEventManager Родительский менеджер событий. |
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| options | — | Тип: Object Опции менеджера событий. |
| options.context | — | Тип: Object Объект, для которого создан менеджер событий. |
| options.controllers | — | Тип: IEventWorkflowController[] Контроллер или контроллеры менеджера событий. |
| options.parent | — | Тип: IEventManager Родительский менеджер событий. |
Методы
| Имя | Возвращает | Описание |
|---|---|---|
| add(types, callback[, context]) | Добавляет новую подписку. Унаследован от IEventManager. | |
| createEventObject(type, event, target) | Функция, которая создает объект-событие. Вызывается в методе fire, когда переданный объект не является экземпляром класса Event или его наследником. | |
| fire(type[, event]) | Бросает событие. | |
| getParent() | Returns родительский менеджер событий. | |
| group() | Returns контейнер событий, привязанный к данному менеджеру. Унаследован от IEventManager. | |
| remove(types, callback[, context]) | Удаляет существующую подписку. Унаследован от IEventManager. | |
| setParent(parent) | Задаёт родительский менеджер событий. |
| Имя | Возвращает | Описание |
|---|---|---|
| add(types, callback[, context]) | Добавляет новую подписку. Унаследован от IEventManager. | |
| createEventObject(type, event, target) | Функция, которая создает объект-событие. Вызывается в методе fire, когда переданный объект не является экземпляром класса Event или его наследником. | |
| fire(type[, event]) | Бросает событие. | |
| getParent() | Returns родительский менеджер событий. | |
| group() | Returns контейнер событий, привязанный к данному менеджеру. Унаследован от IEventManager. | |
| remove(types, callback[, context]) | Удаляет существующую подписку. Унаследован от IEventManager. | |
| setParent(parent) | Задаёт родительский менеджер событий. |
Описание методов
createEventObject
Функция, которая создает объект-событие. Вызывается в методе fire, когда переданный объект не является экземпляром класса Event или его наследником.
Returns объект-событие.
Параметры:
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| type * | — | Тип: String Тип события. |
| event * | — | Тип: Object Объект, описывающий событие. |
| target * | — | Тип: Object Объект, на котором произошло событие. |
* Обязательный параметр/опция.
fire
{event.Manager} fire(type[, event])Бросает событие.
Returns ссылку на себя.
Параметры:
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| type * | — | Тип: String Тип события. |
| event | — | Тип: Object|Event Объект, описывающий событие. Если передан хэш с данными, то для него будет вызван метод createEventObject, и дальнейшие действия будут производиться с новым созданным событием. Значение isImmediatePropagationStopped() проверяется в каждой фазе распространения событий. Значение isPropagationStopped() проверяется перед фазой bubblingEvent. Значение isDefaultPrevented() проверяется перед фазой defaultaction. |
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| type * | — | Тип: String Тип события. |
| event | — | Тип: Object|Event Объект, описывающий событие. Если передан хэш с данными, то для него будет вызван метод createEventObject, и дальнейшие действия будут производиться с новым созданным событием. Значение isImmediatePropagationStopped() проверяется в каждой фазе распространения событий. Значение isPropagationStopped() проверяется перед фазой bubblingEvent. Значение isDefaultPrevented() проверяется перед фазой defaultaction. |
* Обязательный параметр/опция.
getParent
{IEventManager} getParent()Returns родительский менеджер событий.
setParent
{event.Manager} setParent(parent)Задаёт родительский менеджер событий.
Returns ссылку на себя.
Параметры:
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| parent * | — | Тип: IEventManager Родительский менеджер событий. |
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| parent * | — | Тип: IEventManager Родительский менеджер событий. |
* Обязательный параметр/опция.