atomnamedevent v1.1.2

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

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

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

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 ./