attachEvent

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

type	string	название события, без учёта регистра
functor	function	функция или ее имя
id	string	необязательный параметр, ID обработчика

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

Example

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

Related samples

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

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

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
});

Наверх