attachEvent

задает обработчик внутреннего события компонента

id attachEvent(string type,function functor, [string id] );

Parameters

typestringназвание события, без учёта регистра
functorfunctionфункция или ее имя
idstringнеобязательный параметр, ID обработчика

Returns

idID обработчика

Example

dtable.attachEvent("onAfterLoad",function(){
    this.select(2);
});

Related samples

Details

Как задать обработчик

Вы можете использовать метод с встроенной функцией или же предоставить ссылку на глобальную функцию. Во втором случае, убедитесь в том, что функция определена в той же области видимости (скоупе).

function doTask(){ ... };
dtable.attachEvent("onBeforeLoad", doTask); // uses the reference

ID обработчика

Метод attachEvent() автоматически генерирует уникальный ID для обработчика и возвращает его. Вы также можете задать свой ID обработчику вместо сгенерированного автоматически передав его последним параметром. ID используются для удаления обработчика события и чаще всего вполне достаточно автоматического ID.

Параметры функции обработчика и ее возвращаемое значение

Каждый обработчик получает параметры в зависимости от события. Список параметров можно увидеть на страницах справочника API для каждого конкретного события.

Работа компонентов может зависеть от того, что вернет функция обработчика. Например, обработчики событий, названия которых начинаются на onBefore, могут отменять связанные с событиями действия. Если обработчик вернет true или не вернет ничего, компонент будет работать как обычно. Если обработчик вернет false, это сигнал к остановке текущего действия. Например, так можно отменить выделение элемента, по которому кликнул пользователь или для которого был вызван метод select():

dtable.attachEvent("onBeforeSelect", function(id){
    if (id == 123)
        return false; // блокирует выбор элемента c ID=123
});
See also
Наверх
If you have not checked yet, be sure to visit site of our main product Webix javascript website framework and page of javascript spreadshee product.