AtomNamedEvent

version 1.1.2 Event + EventTarget

Обзор

• Зачем
• Установка
• USAGE
• Отличие от предыдущей версии
• Принцип работы
• Свойства и методы
• Наследовани
• Документация JSDoc

Зачем

Цель проста - унифицировать в одном классе всё потребное для работы с событиями, сохранив возможность классической работы с событиями класса Event через интерфейс EventTarget. Предостовляя также возможность прототипного наследования. Пакет представляет единую, крсплатформенную реализацию работы с событиями. Создаёт новые и оборачивает сущиствующие события всеми методами необходимыми для работы с ними. Каждый метод сам знает с каким объектом Event связан. Приэтом каждый метод статичен, т.е один и тотже для всех экземпляров.

Установка

Для установки пакета в качестве зависимомти другого пакета.

npm install atomnamedevent

Что бы скачать git репозиторий пакета - вам так же понадобится git. Выполните в терминалн следующий код

git clone https://github.com/dimkl-dev/AtomNamedEvent.git && cd ./AtomNamedEvent && npm install 

USAGE

Отличие от предыдущей версии

Принцип работы

Класс основан на двух базовых интерфейсах Event и EventTarget Хоть в документации они называются интерфесами - с ними можно работать как с обычными классами... у каждого есть свой конструктор. Конструктор класс AtomNamedEvent возврощает с дополнительными примесями экземпляры класса Event или объекты унаследованных от него(завист от параметров конструктора) . При помощи механизма внешнего интерфейса(смотри разел Внутренние свойства экземпляра и коментарии JSDoc) реализована работа всех методов работы с событиями. Каждый метод статичен(т.е все методы реализованы в единичном экземпляре) но при этом сохроняют контекст вызова(достаточно вызвать метод - и он сам знает с каким экземпляром класса AtomNamedEvent он работает. Это не нужно указывать отдельным способом). Так как конструктор возвращает полноценные объекты - то сохроняется возможность классичечской работы с событиями основаными на интерфесе Event. Так же в AtomNamedEvent можно обернуть существующие события Event

Свойства и методы

constructor(name=(String|Event), [target=EventTarget])

• name - имя для объекта события типа CustomEvent или экземпляр объекта базирующийся на объекте Event.

• target - опциональный парамет позволяющий задать отдельный экземпляр объекта EventTarget. По умолчанию используется экземпляр находящийся в AtomNamedEvent.prototype.target. с помощю него происходит вызов событий и назначаются обработчики событий

Возвращает и устанавливает объект события

AtomNamedEvent.prototype

• target - Объект EventTarget
• addListener(listener) - подписывает функцию listener на срабатывание события
• removeListener(listener) - удаляет listener из обработчиков события.
• dispatchEvent() - генерирует событие
• on() - псевдоним для addListener
• emit() - псевдоним для dispatchEvent
• func - объект для внутренниего использования класс. Вне пределах класса смысла не имеет. В этом объекте определены все методы из него подмешиваются к каждому экземпляру. В ведён ради удобства.

Внутренние свойства экземпляра

Cтрого необходимы для работы. Не трогать их. Без них ничего работать не будет.

• _this - контекст экземпляра класс AtomNamedEvent
• _this.mthis - ссылка на объект Event возвращённая конструктором класса AtomNamedEvent, т.е ссылка объекта Event на самого себя. Проверить это можно выполнив следующий код

Именно эти переменые позволяют реализовать концепции внешнего интерфейса и защищённых полей класса

Наследовани

Пример реализации наследования от класса AtomNamedEvent

Документация JSDoc

Для просмотра документации JSDoc можно использовать пакет JSDocLive

Если вы установили пакет как зависимость, то в каталоге пакета наберите команду

cd ./node_modules/atomnamedevent/ && jsdoclive ./

Если вы скачали git-репозиторий пакета, то в катологе пакета наберите

jsdoclive ./