attachEvent

Description

Привязывает обработчик к внутреннему событию dhtmlxScheduler

attachEvent: (name: SchedulerEventName, handler: SchedulerCallback, settings?: any) => string

Parameters

• name - (required) SchedulerEventName - имя события, регистронезависимое
• handler - (required) function - функция, которая будет обрабатывать событие
• settings - (optional) object - необязательно, объект с настройками для обработчика события

Returns

• event - (string) - id идентификатор привязанного обработчика события

Example

scheduler.attachEvent("onEventSave",function(id,ev){
    if (!ev.text) {
        alert("Текст не должен быть пустым");
        return false;
    }
    return true;
})

Related samples

• Validating lightbox fields
• Recurring events

Details

К одному событию можно привязать несколько обработчиков, и все они будут выполнены.
Если любой из обработчиков возвращает false, связанное действие будет отменено.
Обработчики вызываются в порядке их привязки.

Все слушатели событий, добавленные через event, будут автоматически удалены при вызове destructor.

Свойства объекта settings

Объект settings может содержать два свойства:

1. id - (string) уникальный идентификатор обработчика события

Это позволяет легко удалить конкретный обработчик из события:

scheduler.attachEvent("onClick", function(){
    console.log("event click");
}, {id: "my-click"}); /*!*/
... //позже:
gantt.detachEvent("my-click");

2. once - (boolean) указывает, должен ли обработчик выполниться только один раз

Установите это значение в true, чтобы обработать только первое возникновение события, например так:

scheduler.attachEvent("onClick", function(){
    console.log("capture next event click");
    return true;
}, {once: true}); /*!*/

Related API

• detachEvent