задает обработчик внутреннего события компонента
type | string | название события, без учёта регистра |
functor | function | функция или ее имя |
id | string | необязательный параметр, ID обработчика |
id | ID обработчика |
dtable.attachEvent("onAfterLoad",function(){
this.select(2);
});
Вы можете использовать метод с встроенной функцией или же предоставить ссылку на глобальную функцию. Во втором случае, убедитесь в том, что функция определена в той же области видимости (скоупе).
function doTask(){ ... };
dtable.attachEvent("onBeforeLoad", doTask); // uses the reference
Метод attachEvent() автоматически генерирует уникальный ID для обработчика и возвращает его. Вы также можете задать свой ID обработчику вместо сгенерированного автоматически передав его последним параметром. ID используются для удаления обработчика события и чаще всего вполне достаточно автоматического ID.
Каждый обработчик получает параметры в зависимости от события. Список параметров можно увидеть на страницах справочника API для каждого конкретного события.
Работа компонентов может зависеть от того, что вернет функция обработчика. Например, обработчики событий, названия которых начинаются на onBefore, могут отменять связанные с событиями действия. Если обработчик вернет true или не вернет ничего, компонент будет работать как обычно. Если обработчик вернет false, это сигнал к остановке текущего действия. Например, так можно отменить выделение элемента, по которому кликнул пользователь или для которого был вызван метод select():
dtable.attachEvent("onBeforeSelect", function(id){
if (id == 123)
return false; // блокирует выбор элемента c ID=123
});