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

<b>readonly EventTarget target*</b>

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

<b>EventTarget</b>
.) Это свойство отсутствует в модели событий IE, но имитируется в модели событий jQuery. См. также srcElement.

<b>readonly unsigned long timestamp*</b>

Число, определяющее дату и время, когда произошло событие, или которое можно использовать для определения очередности событий. Многие броузеры возвращают значение времени в секундах, которое можно передать конструктору

<b>Date().</b>
Однако в Firefox версии 4 и ниже это свойство содержит количество миллисекунд, прошедших с момента включения компьютера. Это свойство не поддерживается в модели событий ІБ. Модель событий jQuery записывает в это свойство значение в формате, возвращаемом методом
<b>Date.getTime().</b>

<b>Element toElement</b>

Для событий «mouseover» и «mouseout» в модели событий IE содержит ссылку на объект, в пределы которого был перемещен указатель мыши. В стандартной модели событий вместо этого свойства следует использовать свойство

<b>relatedTarget</b>
.

<b>readonly string type*</b>

Тип события, которое представляет данный объект

<b>Event</b>
. Это имя, под которым был зарегистрирован обработчик события, или имя свойства обработчика события, без префикса «оn». Например, «click», «load» или «submit». Это свойство поддерживаются обеими моделями событий, стандартной и IE.

<b>readonly Window view</b>

Окно (исторически называется «представлением» («view»)), в котором было сгенерировано событие. Это свойство определено для всех стандартных событий пользовательского интерфейса, таких как события мыши и клавиатуры. Не поддерживается в модели событий ІE.

<b>readonly integer wheelDelta</b>

Для событий колесика мыши это свойство определяет величину прокрутки по оси Y. Различные броузеры записывают в это свойство разные значения; подробнее об этом рассказывается в разделе 17.6. Это нестандартное свойство, но оно поддерживается всеми броузерами, включая IE версии 8 и ниже.

<b>readonly integer wheelDeltaX </b>

<b>readonly integer wheelDeltaY</b>

В броузерах, поддерживающих мыши с двумя колесиками, эти события определяют величину прокрутки по осям X и Y. Описание, как следует интерпретировать

эти свойства, приводится в разделе 17.6. Если определено свойство

<b>wheelDeltaY</b>
, оно будет содержать то же значение, что и свойство
<b>wheelDelta</b>
.

<b>readonly integer which</b>

Это нестандартное, устаревшее свойство поддерживается всеми броузерами, кроме IE, и имитируется в библиотеке jQuery. Для событий мыши это еще одно свойство, аналогичное свойству

<b>button</b>
: значение 1 соответствует левой кнопке, 2 -средней кнопке и 3 - правой. Для событий клавиатуры оно получает то же значение, что и свойство
<b>keyCode</b>
.

Методы

Все следующие методы определены непосредственно в классе

<b>Event</b>
, поэтому все они доступны в любом стандартном объекте
<b>Event</b>
.

<b>void initEvent(string type, boolean bubbles, boolean cancelable)</b>

Инициализирует свойства

<b>type, bubbles</b>
и
<b>cancelable</b>
объекта
<b>Event</b>
. Создать новый объект события можно вызовом
<b>createEvent()</b>
объекта
<b>Document</b>
, передав ему строку «Event». После инициализации объекта события вызовом этого метода его можно послать любому объекту, поддерживающему интерфейс
<b>EventTarget</b>
, вызвав метод
<b>dispatchEvent()</b>
этого объекта. Другие стандартные свойства объекта события (помимо
<b>type, bubbles</b>
и
<b>cancelable</b>
) будут инициализированы во время отправки. Если потребуется создать, инициализировать и послать более сложное искусственное событие, необходимо передать методу
<b>createEvent()</b>
другой аргумент (такой как «MouseEvent») и затем инициализировать полученный объект события с помощью специализированной функции, такой как
<b>initMouseEvent()</b>
(не описывается в этой книге).

<b>void preventDefault()</b>

Сообщает веб-броузеру, чтобы он не выполнял действие по умолчанию для этого события, если таковое предусмотрено. Если событие относится к категории неотменяемых, вызов этого метода не оказывает никакого влияния. Этот метод отсутствует в модели событий IE, но имитируется библиотекой jQuery. В модели событий IE вместо вызова этого метода следует присваивать значение false свойству

<b>returnValue</b>
.

<b>void stopImmediatePropagation()</b>

Действует подобно методу

<b>stopPropagation(),</b>
но, кроме того, предотвращает вызов остальных обработчиков, зарегистрированных в этом же элементе документа. Этот метод является новым расширением стандартной модели событий, и потому может быть реализован не во всех броузерах. Не поддерживается моделью событий IE, но имитируется библиотекой jQuery.

<b>void stopPropagation()</b>

Останавливает распространение события по фазам захвата или всплытия и передачу его целевому элементу. Этот метод не отменяет вызов других обработчиков событий того же узла документа, но предотвращает передачу событий любым другим узлам. Не поддерживается моделью событий IE, но имитируется библиотекой jQuery. В IE вместо вызова метода

<b>stopPropagation()</b>
следует присваивать значение true свойству
<b>cancelBubble</b>
.

Предлагаемые к реализации свойства

Свойства, перечисленные ниже, предлагаются проектом спецификации «DOM Level 3 Events». Они должны решить основные проблемы несовместимости между броузерами, но пока (на момент написания этих слов) не реализованы ни в одном из броузеров. Если они будут реализованы совместимым способом, это существенно упростит создание переносимого программного кода для обработки событий ввода текста, нажатий клавиш и событий мыши.

<b>readonly unsigned short buttons</b>