Event - событие¶

События DOM Level 0 - функции, которые записываются DOM-элементам в атрибуты с приставкой on.

События DOM Level 2 - функции, которые добавляются в елементы с помощью функции addEventListener

class Event¶

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

bubbles¶

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

Отсутствует в модели событий IE.

button¶

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

Кроме того, это свойство не является битовой маской: оно не позволяет сообщить обработчику об изменении состояния более чем одной кнопки. Наконец, некоторые броузеры генерируют события только для левой кнопки.

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

buttons¶: Напоминает свойство 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 имитирует их во всех броузерах.

relatedTarget¶: Ссылается на элемент (обычно элемент документа) 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: Тип события

Event - событие¶

Previous topic

Next topic

This Page