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

В стандартной модели событий для различных типов событий определены различные типы объектов событий, связанных с ними: по событиям мыши, например, обработчикам передается объект

со свойствами, имеющими отношение к мыши, а по событиям клавиатуры передается объект со свойствами, имеющими отношение к клавиатуре. Оба типа, и , наследуют общий суперкласс . Однако в моделях событий IE и jQuery по всем событиям, возникающим в объектах , передаются объекты единого типа Event. Свойства объекта Event, имеющие отношение к клавиатуре, не будут иметь сколько-нибудь осмысленные значения в обработчике события мыши, но сами свойства будут определены в объекте. Для простоты в этой справочной статье не рассматривается иерархия событий и описываются свойства всех событий, которые могут получить объекты (и затем всплыть до объектов и ).

Первоначально практически все события в клиентских сценариях генерировались в элементах документа, поэтому такое смешивание свойств, имеющих отношение к документу, в одном объекте выглядит вполне естественным. Однако HTML5 и связанные с ним стандарты определяют множество новых типов событий, которые генерируются в объектах, не являющихся элементами документа. Для этих типов событий часто определяются собственные объекты событий, и этим объектам посвящены собственные справочные статьи. См. статьи

и . Большинство из этих типов объектов событий расширяют тип . Для других новых типов событий, появившихся в стандарте HTML5, их отдельные типы объектов событий не определяются - обработчикам этих событий передается обычный объект . Данная справочная статья описывает этот «обычный» объект , плюс некоторые из его подтипов. Свойства в списке ниже, помеченные звездочкой, определяются непосредственно типом . Эти свойства наследуются такими объектами событий, как , и используются при работе с простыми событиями, такими как событие «load» объекта и событие «playing» объекта .

Константы

Следующие константы определяют значения свойства

. Это свойство и эти константы не поддерживаются моделью событий, реализованной в ІE.

Событие посылается перехватывающим обработчикам событий в предках целевого объекта.

Событие посылается обработчикам целевого объекта

Событие всплывает и посылается обработчикам событий в предках целевого объекта.

Свойства

Следующие свойства определяются стандартной моделью для объекта

событий, а также для объектов событий, связанных с событиями мыши и клавиатуры. В этот список также включены свойства, определяемые моделями событий ІE и jQuery. Свойства, помеченные звездочкой, определены непосредственно в объекте и доступны в любых стандартных объектах событий, независимо от типов событий, с которыми они связаны.

Указывает, удерживалась ли нажатой клавиша Alt в момент события. Определено для событий мыши и клавиатуры, а также в модели событий IE.

Значение true, если тип события поддерживает «всплытие» (и если не вызван метод

), и false - в противном случае. Отсутствует в модели событий IE.

Указывает, изменение состояния какой кнопки мыши вызвало событие «mousedown», «mouseup» или «click». Значение 0 соответствует левой кнопке, значение 2 -правой и значение 1 - средней кнопке мыши. Обратите внимание, что значение этого свойства определено только для событий, связанных с изменением состояния кнопки мыши - оно не используется, например, чтобы сообщить, какая кнопка удерживалась при возникновении события «mousemove». Кроме того, это свойство не является битовой маской: оно не позволяет сообщить обработчику об изменении состояния более чем одной кнопки. Наконец, некоторые броузеры генерируют события только для левой кнопки.

Модель событий IE определяет несовместимое свойство

. В этом броузере данное свойство является битовой маской: бит 1 устанавливается, когда была нажата левая кнопка, бит 2 - когда была нажата правая кнопка и бит 4 - когда была нажата средняя кнопка (трехкнопочной) мыши. Библиотека jQuery не имитирует стандартное свойство в IE, вместо этого она реализует свойство .

Значение true, если действие, предлагаемое по умолчанию и связанное с событием, может быть отменено с помощью метода

и false - в противном случае. Определено во всех стандартных объектах событий и отсутствует в модели событий IE.

В модели событий IE, чтобы в обработчике события остановить дальнейшее распространение события вверх по дереву вмещающих объектов, в это свойство нужно записать значение true. В стандартной модели событий для этой цели следует использовать метод

Для событий «keypress» это свойство содержит код Юникода сгенерированного печатного символа. Данное свойство равно нулю в случае нажатия функциональной клавиши. Оно не используется событиями «keydown» и «кеуир». Преобразовать это число в строку можно с помощью метода

Для событий «keypress» то же самое значение большинство броузеров записывают в свойство . Однако в Firefox свойство не определено для события «keypress», поэтому следует использовать свойство . Данное свойство является нестандартным, отсутствует в модели событий IE и не имитируется в модели событий jQuery.