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