События DOM Level 0 - функции, которые записываются DOM-элементам в атрибуты с приставкой on.
События DOM Level 2 - функции, которые добавляются в елементы с помощью функции addEventListener
Event
altKey
Указывает, удерживалась ли нажатой клавиша Alt в момент события. Определено для событий мыши и клавиатуры, а также в модели событий IE.
bubbles
Значение true, если тип события поддерживает «всплытие» (и если не вызван метод stopPropagation()), и false – в противном случае.
Отсутствует в модели событий IE.
Указывает, изменение состояния какой кнопки мыши вызвало событие «mouse down», «mouseup» или «click». Значение 0 соответствует левой кнопке, значение 2 – правой и значение 1 – средней кнопке мыши. Обратите внимание, что значение этого свойства определено только для событий, связанных с изменением состояния кнопки мыши – оно не используется, например, чтобы сообщить, какая кнопка удерживалась при возникновении события «mousemove».
Кроме того, это свойство не является битовой маской: оно не позволяет сообщить обработчику об изменении состояния более чем одной кнопки. Наконец, некоторые броузеры генерируют события только для левой кнопки.
Модель событий IE определяет несовместимое свойство button. В этом броузере данное свойство является битовой маской: бит 1 устанавливается, когда была нажата левая кнопка, бит 2 – когда была нажата правая кнопка и бит 4 – когда была нажата средняя кнопка (трехкнопочной) мыши.
Напоминает свойство button, поддерживаемое в модели событий IE и описанное выше.
cancelable
Значение true, если действие, предлагаемое по умолчанию и связанное с событием, может быть отменено с помощью метода preventDefault(), и false – в противном случае.
Определено во всех стандартных объектах событий и отсутствует в модели событий IE.
cancelBubble
В модели событий IE, чтобы в обработчике события остановить дальнейшее распространение события вверх по дереву вмещающих объектов, в это свойство нужно записать значение true.
В стандартной модели событий для этой цели следует использовать метод stopPropagation().
char
Для событий клавиатуры это свойство хранит строку символов (т. е. может содержать более одного символа), сгенерированную событием.
charCode
Для событий «keypress» это свойство содержит код Юникода сгенерированного печатного символа. Данное свойство равно нулю в случае нажатия функциональной клавиши. Оно не используется событиями «keydown» и «keyup». Преобразовать это число в строку можно с помощью метода String.fromCharCode(). Для событий «key press» то же самое значение большинство броузеров записывают в свойство keyCode. Однако в Firefox свойство keyCode не определено для события «keypress», поэтому следует использовать свойство charCode. Данное свойство является нестандартным, отсутствует в модели событий IE и не имитируется в модели событий jQuery.
clientX
clientY
Координаты X и Y указателя мыши относительно клиентской области или окна броузера. Обратите внимание: эти координаты не учитывают величину прокрутки документа; если событие происходит на верхнем краю окна, свойство clientY будет равно 0 независимо от того, как далеко выполнена прокрутка документа. Эти свой ства определены для всех типов событий мыши, и в модели событий IE, и в стандартной модели. См. также pageX и pageY.
ctrlKey
Указывает, удерживалась ли нажатой клавиша Ctrl в момент события. Определено для событий мыши и клавиатуры, а также в модели событий IE.
currentTarget
Объект Element, Document или Window, обрабатывающий событие в данный момент. Во время фазы перехвата и всплытия значение свойства отличается от target.
data
Для событий «textinput» определяет введенный текст.
dataTransfer
Для событий буксировки (drag-and-drop) это свойство определяет объект DataTransfer
, полностью координирующий выполнение операции буксировки.
События буксировки относятся к событиям мыши; любое событие, имеющее это свойство, также будет иметь свойства clientX, clientY и другие, свойственные событиям мыши.
События буксировки «dragstart», «drag» и «dragend» возбуждаются в объекте-источнике; а события «dragenter», «dragover», «dragleave» и «drop» – в объекте-приемнике.
defaultPrevented
Значение true, если обработчик этого события вызвал defaultPrevented(), и false – в противном случае. Это новое расширение стандартной модели событий, и потому может быть реализовано не всеми броузерами. (Модель событий jQuery определяет метод isDefaultPrevented(), действующий подобно этому свойству.)
deltaMode
Для событий колесика мыши это свойство определяет соответствующую интерпретацию свойств deltaX, deltaY и deltaZ. Значением этого свойства может быть одна из констант: DOM_DELTA_PIXEL, DOM_DELTA_LINE, DOM_DELTA_PAGE. Конкретное значе ние определяется платформой и может зависеть от настроек системы или от факта удерживания нажатыми клавиш-модификаторов во время возникновения собы тия колесика мыши.
deltaX, deltaY, deltaZ
Для событий колесика мыши эти свойства определяют величину прокрутки по каждой из трех осей.
detail
Сведения о событии (число). Для событий «click», «mousedown» и «mouseup» это свойство показывает количество щелчков: 1 – одинарный щелчок, 2 – двойной щелчок, 3 – тройной щелчок и т. д. В Firefox это свойство используется событиями «DOMMouseScroll», чтобы сообщить величину прокрутки колесика мыши.
eventPhase
Текущая фаза распространения события. Значение свойства – одна из трех констант, описанных выше. Не поддерживается в модели событий IE.
CAPTURING_PHASE = 1, событие посылается перехватывающим обработчикам событий в предках целево го объекта.
AT_TARGET = 2, Событие посылается обработчикам целевого объекта
BUBBLING_PHASE = 3, Событие всплывает и посылается обработчикам событий в предках целевого объекта.
fromElement
Для событий «mouseover» и «mouseout» в модели IE свойство fromElement содержит ссылку на объект Element
, с которого двигался указатель мыши. В стандартной модели событий следует использовать свойство relatedTarget.
inputMethod
Для событий «textinput» это свойство определяет способ ввода текста. Значением этого свойства может быть одна из констант: DOM_INPUT_METHOD_UNKNOWN, DOM_INPUT_METHOD_KEYBOARD, DOM_INPUT_METHOD_PASTE, DOM_INPUT_METHOD_DROP, DOM_INPUT_METHOD_IME,DOM_INPUT_METHOD_OPTION, DOM_INPUT_METHOD_HANDWRITING, DOM_INPUT_METHOD_VOICE, DOM_INPUT_METHOD_MULTIMODAL, DOM_INPUT_METHOD_SCRIPT.
isTrusted
Значение true, если это событие было создано и послано броузером, и false – если это искусственное событие, созданное и посланное сценарием на языке JavaScript. Это относительно новое расширение стандартной модели событий, и потому может быть реализовано не всеми броузерами.
key
Для событий клавиатуры, генерирующих символы, это свойство получает то же значение, что и свойство char. Для событий клавиатуры, не генерирующих символы, это свойство содержит имя нажатой клавиши (такое как, «Tab» или «Down»).
keyCode
Виртуальный код нажатой клавиши. Это свойство используется всеми типами событий клавиатуры. Код клавиши может зависеть от броузера, операционной системы, самой клавиатуры. Обычно, если на клавише изображен печатный символ, виртуа льный код этой клавиши совпадает с кодом символа. Коды функциональных клавиш, не соответствующих печатным символам, могут существенно отличаться. Это свойство не было стандартизовано, но определяется всеми броузерами, включая IE.
locale
Для событий клавиатуры и событий «textinput» это свойство определяет код языка (например, «en-GB»), идентифицирующий выбранную раскладку клавиатуры,если эта информация доступна.
location
Для событий клавиатуры это свойство определяет местоположение нажатой клавиши. Значением этого свойства может быть одна из констант: DOM_KEY_LOCATION_STANDARD, DOM_KEY_LOCATION_LEFT, DOM_KEY_LOCATION_RIGHT, DOM_KEY_LOCATION_NUMPAD, DOM_KEY_LOCATION_MOBILE, DOM_KEY_LOCATION_JOYSTICK.
metaKey
Признак, показывающий, удерживалась ли клавиша Meta, когда произошло событие. Свойство определено для всех типов событий мыши и клавиатуры, а также в модели событий IE.
offsetX, offsetY
В модели событий IE эти свойства определяют координаты, в которых возникло событие, в координатной системе элемента-источника события (см. описание свой ства srcElement). Стандартная модель событий не имеет эквивалентных свойств.
pageX, pageY
Эти нестандартные, но широко поддерживаемые свойства подобны свойствам clientX и clientY, но вместо системы координат окна используют систему координат документа. Эти свойства отсутствуют в модели событий IE, но библиотека jQuery имитирует их во всех броузерах.
Ссылается на элемент (обычно элемент документа) EventTarget
, который имеет отношение к целевому элементу события. Для событий «mouseover» это элемент, который покинул указатель мыши при наведении на целевой элемент. Для событий «mouseout» это элемент, на который наводится указатель мыши, когда он покидает целевой элемент. Это свойство отсутствует в модели событий IE, но оно имитируется в модели событий jQuery. См. также свойства fromElement и toElement, определяемые в модели событий IE.
repeat
Для событий клавиатуры это свойство будет иметь значение true, если событие вызвано длительным удержанием клавиши в нажатом состоянии, вызвавшем автоповтор ввода.
returnValue
Чтобы в модели событий IE предотвратить выполнение действия, предусмотреного по умолчанию элементом - источником, в котором возникло событие, данное свойство следует установить в значение false.
В стандартной модели событий следует использовать метод preventDefault().
screenX, screenY
Для событий мыши эти свойства определяют координаты указателя мыши относительно верхнего левого угла экрана. Сами по себе эти свойства не используются, но они определены во всех типах событий мыши и поддерживаются обеими моделями событий, стандартной и IE.
shiftKey
Указывает, удерживалась ли нажатой клавиша Shift в момент события. Определено для событий мыши и клавиатуры, а также в модели событий IE.
srcElement
В модели событий IE это свойство определяет объект EventTarget
, в котором было сгенерировано событие. В стандартной модели событий вместо этого свойства следует исполь зовать свойство target.
target
Целевой объект события EventTarget
, т. е. объект, в котором было сгенерировано событие. (Все объекты, которые могут быть целевыми объектами событий, реализуют методы интерфейса EventTarget.) Это свойство отсутствует в модели событий IE, но имитируется в модели событий jQuery. Cм. также srcElement.
timeStamp
Число, определяющее дату и время, когда произошло событие, или которое можно использовать для определения очередности событий. Многие броузеры возвращают значение времени в секундах, которое можно передать конструктору Date(). Однако в Firefox версии 4 и ниже это свойство содержит количество миллисекунд, прошедших с момента включения компьютера. Это свойство не поддерживается в модели событий IE. Модель событий jQuery записывает в это свойство значение в формате, возвращаемом методом Date.getTime().
toElement
Для событий «mouseover» и «mouseout» в модели событий IE содержит ссылку на объект Element
, в пределы которого был перемещен указатель мыши. В стандартной модели событий вместо этого свойства следует использовать свойство relatedTarget.
type
Тип события, которое представляет данный объект Event. Это имя, под которым был зарегистрирован обработчик события, или имя свойства обработчика события, без префикса «on». Например, «click», «load» или «submit». Это свойство поддерживаются обеими моделями событий, стандартной и IE.
view
Окно Window
(исторически называется «представлением» («view»)), в котором было сгенерировано событие. Это свойство определено для всех стандартных событий пользовательского интерфейса, таких как события мыши и клавиатуры. Не поддерживается в модели событий IE.
wheelDelta
Для событий колесика мыши это свойство определяет величину прокрутки по оси Y. Различные броузеры записывают в это свойство разные значения. Это нестандартное свойство, но оно под держивается всеми броузерами, включая IE версии 8 и ниже.
wheelDeltaX
wheelDeltaY
В броузерах, поддерживающих мыши с двумя колесиками, эти события определяют величину прокрутки по осям X и Y. Если определено свойство wheelDeltaY, оно будет содержать то же значение, что и свойство wheelDelta.
which
Это нестандартное, устаревшее свойство поддерживается всеми броузерами, кроме IE, и имитируется в библиотеке jQuery. Для событий мыши это еще одно свойство, аналогичное свойству button: значение 1 соответствует левой кнопке, 2 – средней кнопке и 3 – правой. Для событий клавиатуры оно получает то же значение, что и свойство keyCode.
getModifierState
(string modifier)Для событий мыши и клавиатуры этот метод возвращает true, если в момент возбуждения события удерживалась нажатой указанная клавиша-модификатор modifier, и false – в противном случае. Значением аргумента modifier может быть одна из строк: «Alt», «AltGraph», «CapsLock», «Control», «Fn», «Meta», «NumLock», «Scroll», «Shift», «SymbolLock» и «Win».
initEvent
(type, bubbles, cancelable)Инициализация ивента
initUIEvent
()initMouseEvent
()preventDefault
()Отмена действия по умолчанию.
Сообщает веб-броузеру, чтобы он не выполнял действие по умолчанию для этого события, если таковое предусмотрено.
Например сабмит формы, переход по ссылке.
Если событие относится к категории неотменяемых, вызов этого метода не оказывает никакого влияния.
Этот метод отсутствует в модели событий IE, вместо вызова этого метода следует присваивать значение false свойству returnValue.
formElement.onsubmit = function(evt){
// отменяет стандартную отправку формы
evt.preventDefault();
}
stopImmediatePropagation
()Действует подобно методу stopPropagation(), но, кроме того, предотвращает вызов остальных обработчиков, зарегистрированных в этом же элементе документа.
Этот метод является новым расширением стандартной модели событий, и потому может быть реализован не во всех броузерах.
Не поддерживается моделью событий IE, но имитируется библиотекой jQuery.
StopPropagation
()Прекращает распространение события по элементам.
Этот метод не отменяет вызов других обработчиков событий того же узла документа, но предотвращает передачу событий любым другим узлам.
Не поддерживается моделью событий IE, но имитируется библиотекой jQuery.
В IE вместо вызова метода stopPropagation() следует присваивать значение true свойству cancelBubble.
altKey
Булево, нажата кнопка Альт
bubbles
Булево, событие может всплывать по дереву элементов.
События blur, focus, load, unload не всплывают
button
Номер кнопки мыши, 0 - левая, 1 - средняя, 2 - правая (1,2,4 для IE)
cancelable
Булево,
с этим событием связано действие по умолчанию и
его можно отменить с помощью метода preventDefault()
cancelBubble
Аналог stopPropagation()
для IE
charCode
Код клавиши события
clientX, clientY
Координаты относительно левого верхнего угла документа
ctrlKey
Булево, кнопка Ctrl нажата
currentTarget
Элемент, событие которого исполняется в данное время
eventPhase
Число, указывающее этап
Event.CAPTURING_PHASE
Event.AT_TARGET
Event.BUBBLING_PHASE
keyCode
Код клавииш для события
offsetX, offsetY
Координаты, относительно элемента, в котором произошло событие. Для IE
returnValue
Аналог preventDefault()
для IE
screenX, screenY
Координаты относительно экрана
shiftKey
Булево, кнопка Shift нажата
srcElement
Отправитель события, для IE
target
Элемент, который был инициатором события
timeStamp
Дата события
type
Тип события