Книга: JavaScript. Подробное руководство, 6-е издание

EventTarget

EventTarget

объект, способный принимать события

Объекты, для которых генерируются события, и объекты, которые находятся на пути всплывающих событий, должны предоставлять возможность определять обработчики этих событий. Такие объекты обычно определяют свойства обработчиков событий, имена которых начинаются с префикса «оn» и, как правило, определяют методы, описываемые ниже. Регистрация обработчиков событий - поразительно сложная тема. За подробностями обращайтесь к разделу 17.2 и обратите внимание, что ІE версии 8 и ниже использует другие методы, чем все остальные броузеры; эти методы будут описаны в специальном разделе ниже.

Методы

void addEventListener(string type,function listener,[boolean useCapture])

Регистрирует функцию listener в качестве обработчика событий типа type. Аргумент type - строка с именем без префикса «оn». Аргумент useCapture должен иметь значение true, если регистрируется перехватывающий обработчик (раздел 17.2.3) в предке элемента, являющегося истинной целью события. Обратите внимание, что некоторые броузеры все еще требуют передачи этой функции третьего аргумента, поэтому при регистрации обычного, неперехватывающего, обработчика в третьем аргументе следует передавать false,

boolean dispatchEvent(Event event)

Отправляет данному элементу искусственное событие event. Чтобы отправить событие, необходимо создать новый объект Event вызовом метода document.createEvent() с именем события (таким как «Events», в случае простого события). Затем инициализировать его методом инициализации созданного объекта Event: для простых событий - вызовом метода initEvent() (см. Event). После этого отправить инициализированное событие, передав его рассматриваемому методу. В современных броузерах каждый объект Event имеет свойство isTrusted. Для искуственных событий, посылаемых программно, это свойство будет иметь значение false. Различные типы объектов событий определяют собственные методы инициализации. Эти методы редко используются на практике, имеют длинные списки аргументов и не описываются в этой книге. Если вам потребуется создать, инициализировать и послать искуственное событие, более сложное, чем простой объект Event, поищите описание соответствующего метода инициализации в электронной документации.

void removeEventListener(string type, function listener, [boolean useCapture])

Удаляет зарегистрированный обработчик listener события. Принимает те же аргументы, что и метод addEventListener().

Методы Internet Explorer

IE версии 8 и ниже не поддерживает методы addEventListener() и removeEventListener(). Вместо них он реализует два более простых метода, которые описываются ниже. (Некоторые важные отличия перечислены в разделе 17.2.4.)

void attachEvent(string type, function listener)

Регистрирует функцию listener как обработчик событий типа type. Обратите внимание, что этот метод требует, чтобы имя в аргументе type включало префикс «оn».

void detachEvent(string type, function listener)

Этот метод действует как обратный методу attachEvent().

Оглавление книги