Функции для создания слушателей событий, изменения свойств и создания событий.
Находится в базовом файле y5.js.
notify
y5.Events.notify(type, element, dispatch, event, permanent) -> y5.Event, y5.Notifier
Создает событие на элементе.
| Имя аргумента | Тип | Описание |
|---|---|---|
| type | String | тип события: click, mousedown... (если не указан, то используется click) |
| element | Object | целевой элемент события (если не указан, то используется document) |
| dispatch | Boolean | отправить событие (если не указано, то событие возникает сразу) |
| event | Object | параметры события |
| permanent | Boolean | "постоянное" событие |
Пример:
// создать событие "mousedown" на элементе y5.Events.notify("mousedown", element); // создать событие "click" на документе y5.Events.notify(); // создать событие "click" на элементе var evt = y5.Events.notify("mousedown", element, false); // ... // выполнить его позже // evt.dispatch()
observe
y5.Events.observe(type, listener, element, add, context, runOnce) -> y5.AEventListener, y5.Observer, Array
Создает один или несколько объектов-слушателей.
| Имя аргумента | Тип | Описание |
|---|---|---|
| type | String, Array | тип события: click, load... |
| listener | Function | callback-функция на возникновение события |
| element | Element, Object | объект на котором возникает событие |
| add | Boolean | начать слушать немедленно (false - по умолчанию) |
| context | Object | контекст выполнения функции listener |
| runOnce | Boolean | обработать событие один раз и удалить обработчик. По умолчанию, false. |
Пример:
y5.Events.observe("click", callback, element, true);
observeEvent
y5.Events.observeEvent(type, listener, element, add, context, runOnce)
Создает один объект-слушатель.
| Имя аргумента | Тип | Описание |
|---|---|---|
| type | ||
| listener | ||
| element | ||
| add | ||
| context | ||
| runOnce |
observeInput
y5.Events.observeInput(listener, element, add, context) -> y5.InputObserver
Слушатель изменения элемента ввода.
| Имя аргумента | Тип | Описание |
|---|---|---|
| listener | Function | callback-функция |
| element | Element | элемент |
| add | Boolean | начать слушать немедленно (false - по умолчанию) |
| context | Object | контекст выполнения функции listener |
Пример:
y5.Events.observeInput("value", callback, element, true);
observeOnce
y5.Events.observeOnce(types, listener, element, add, context) -> y5.AEventListener, y5.Observer, Array
Создает один или несколько одноразовых объектов-слушателей, обработчики удаляются после наступления события.
| Имя аргумента | Тип | Описание |
|---|---|---|
| types | String, Array | тип события: click, load... |
| listener | Function | callback-функция на возникновение события |
| element | Element, Object | объект на котором возникает событие |
| add | Boolean | начать слушать немедленно (false - по умолчанию) |
| context | Object | контекст выполнения функции listener |
Пример:
y5.Events.observe("click", callback, element, true);
observeProperty
y5.Events.observeProperty(property, listener, element, add, context, runOnce) -> y5.AEventListener
Слушатель изменения свойств элемента.
| Имя аргумента | Тип | Описание |
|---|---|---|
| property | String | свойство |
| listener | Function | callback-функция |
| element | Element | элемент |
| add | Boolean | начать слушать немедленно (false - по умолчанию) |
| context | Object | контекст выполнения функции listener |
| runOnce | Boolean | обработать событие один раз и удалить обработчик. По умолчанию, false. |
Пример:
y5.Events.observeProperty("value", callback, element, true);
observePropertyOnce
y5.Events.observePropertyOnce(property, listener, element, add, context) -> y5.AEventListener
Одноразовый слушатель изменения свойств элемента. После наступления события обработчик удаляется.
| Имя аргумента | Тип | Описание |
|---|---|---|
| property | String | свойство |
| listener | Function | callback-функция |
| element | Element | элемент |
| add | Boolean | начать слушать немедленно (false - по умолчанию) |
| context | Object | контекст выполнения функции listener |
Пример:
y5.Events.observeProperty("value", callback, element, true);
observeTimer
y5.Events.observeTimer(listener, period, add, context) -> y5.TimerObserver
Вызов функции по таймеру.
| Имя аргумента | Тип | Описание |
|---|---|---|
| listener | Function | callback-функция |
| period | Number | периодичность запуска функции (в секундах) |
| add | Boolean | начать слушать немедленно (false - по умолчанию) |
| context | Object | контекст выполнения функции listener |
Пример:
function callback(observer) { // ... // останавливаем таймер после 10 запусков if (observer.tick == 10) { observer.remove(); } } y5.Events.observeTimer(callback, 5, true);