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

Флэнаган Дэвид

readonly boolean metaKey

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

readonly integer offsetX, offsetY

В модели событий IE эти свойства определяют координаты, в которых возникло событие, в координатной системе элемента-источника события (см. описание свойства

srcElement

). Стандартная модель событий не имеет эквивалентных свойств.

readonly integer pageX, pageY

Эти нестандартные, но широко поддерживаемые свойства

подобны свойствам

clientX

и

clientY

, но вместо системы координат окна используют систему координат документа. Эти свойства отсутствуют в модели событий IE, но библиотека jQuery имитирует их во всех броузерах.

readonly EventTarget relatedTarget*

Ссылается на элемент (обычно элемент документа), который имеет отношение к целевому элементу события. Для событий «mouseover» это элемент, который покинул указатель мыши при наведении на целевой элемент. Для событий «mouseout» это элемент, на который наводится указатель мыши, когда он покидает целевой элемент. Это свойство отсутствует в модели событий IE, но оно имитируется в модели событий jQuery. См. также свойства

fromElement

и

toElement

, определяемые в модели событий IE.

boolean returnValue

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

preventDefault.

readonly long screenX, screenY

Для событий мыши эти свойства определяют координаты указателя мыши относительно верхнего левого угла экрана. Сами по себе эти свойства не используются, но они определены во всех типах событий мыши и поддерживаются обеими моделями событий, стандартной и ІБ.

readonly boolean shiftKey

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

readonly EventTarget srcElement

В модели событий IE это свойство определяет объект, в котором было сгенерировано событие. В стандартной модели событий вместо этого свойства следует использовать свойство

target

.

readonly EventTarget target*

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

EventTarget

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

readonly unsigned long timestamp*

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

Date.

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

Date.getTime.

Element toElement

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

этого свойства следует использовать свойство

relatedTarget

.

readonly string type*

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

Event

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

readonly Window view

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

readonly integer wheelDelta

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

readonly integer wheelDeltaX

readonly integer wheelDeltaY

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

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

wheelDeltaY

, оно будет содержать то же значение, что и свойство

wheelDelta

.

readonly integer which

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

button

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

keyCode

.

Методы

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

Event

, поэтому все они доступны в любом стандартном объекте

Event

.

void initEvent(string type, boolean bubbles, boolean cancelable)

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

type, bubbles

и

cancelable

объекта

Event

. Создать новый объект события можно вызовом

createEvent

объекта

Document

, передав ему строку «Event». После инициализации объекта события вызовом этого метода его можно послать любому объекту, поддерживающему интерфейс

EventTarget

, вызвав метод

dispatchEvent

этого объекта. Другие стандартные свойства объекта события (помимо

type, bubbles

и

cancelable

) будут инициализированы во время отправки. Если потребуется создать, инициализировать и послать более сложное искусственное событие, необходимо передать методу

createEvent

другой аргумент (такой как «MouseEvent») и затем инициализировать полученный объект события с помощью специализированной функции, такой как

initMouseEvent

(не описывается в этой книге).