event NN 4   IE 4   DOM 2

Объект event содержит информацию о пользовательских и системных событиях. В Navigator и Internet Explorer механизмы event весьма различны. За редким исключением, свойства объекта event для этих двух браузеров взаимоисключающие. Тщательно следите за совместимостью.

 
 
Объектно-ориентированная модель (см. Модели событий - Ссылки на объект события)
NN eventObj
IE window.event

Свойства:


altKey NN 6  IE 4   DOM 2
  Только чтение
 

Показывает состояние клавиши Alt во время обработки события.

 
Пример:

if (event.altKey) { handle case of Alt key down }

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

altLeft, ctrlLeft, shiftLeft NN n/a  IE 5.5  DOM n/a
  Только чтение
 

Некоторые версии Windows во время использования IE5+ позволяют модифицировать события только с помощью левых клавиш-модификаторов. Свойства показывают нажатость именно левых клавиш.

 
 
 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

behaviorCookie, behaviorPart NN n/a  IE 5.5  DOM n/a
  Только чтение
 

Эти свойства относятся к технологии Windows, которую Microsoft называет "поведением отображения". В отличие от поведений, описанных в время обсуждения метода addBehavior(), поведения отображения написаны на C++ и предоставляют возможность рисования на web-страницах. Подробно об этом можно узнать на узле http://msdn.microsoft.com/workshop/browser/editing/imprendbehav.asp.

 
 
 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: Ничего

bookmarks, boundElements, dataFld, qualifier, reason (также см.далее ), recordset NN n/a  IE 4+(кроме IE5/Mac)  DOM n/a
  Только чтение
 

Эта группа свойств объектов event связвна с использованием технологии data binding (связывание данных) в IE4+/Win. Подробнее об этой технологии можно узнать на http://msdn.microsoft.com/workshop/. В таблице показаны ADO-свойства (Active Data Object) объекта event:

Свойство Значение параметра Впервые представлен Описание
bookmarks Массив IE4 Массив закладок ADO (сохранённых позиций) для записей, связанных с объектом, который получил событие.
boundElements Массив IE5 Массив ссылок на все элементы, связанные с одним набором данных, который был затронут текущим событием
dataFld Строчный IE5 Имя столбца с данными, которая связана с ячейкой таблицы, которая получает событие cellchange
qualifier Строчный IE5 Имя члена данных, связанного с источником данных, получающего событие. Доступно только если объект - источник данных (DSO) разрешает существование членов данных со многими именами или, если классификатор был явным образом установлен с помощью атрибута DATASRC элемента. В IE5 доступно для чтения и записи
reason Целочисленный IE4 Устанавливается только из события onDataSetComplete; представляет код результата загрузки данных (0=успешный; 1=прервано;2=ошибка)
recordset Объект IE4 Ссылка на текущую запись в источнике данных.
 
 
 
Возвращаемое значение:
См. текст
 
Значение по умолчанию: Ничего

button NN 6  IE 4   DOM 2
  Только чтение
 

Какая кнопка мыши была нажата, чтобы вызвать событие. Хотя теоретически Вы способны обнаружить кнопку right, Internet Explorer 4 не обрабатывает события мыши с правой кнопкой, так как она служит для контекстного меню.

 
Пример:

if (event.button == 1) { handle event for left button }

 
Возвращаемое значение:
Любое из следующих целых чисел: 0 (нет кнопки) | 1 (левая) | 2 (правая) | 4 (средняя).
 
Значение по умолчанию: 0

bubbles NN 6  IE n/a  DOM 2
  Только чтение
 

Не все события являются всплывающими. Некоторые (например, submit) не проходят дальше своего элемента. Если событие не является всплывающим, данное свойство содержит значение false. В противном случае - true.

 
 
 
Возвращаемое значение:
Булево
 
Значение по умолчанию: Зависит от события

cancelBubble NN 6  IE 4   DOM 2
  Чтение/Изменение
 

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

 
Пример:

window.event.cancelBubble = true

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

cancelable NN 6  IE 4   DOM 2
  Чтение/Изменение
 

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

 
 
 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

charCode NN 6  IE n/a  DOM 2
  Чтение/Изменение
 

Эквивалентно KeyCode. Отличие в том, что свойство всегда нулевое для событий KeyDown и KeyUp

 
 
 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего

clientX, clientY NN 6  IE 4   DOM 2
 Только чтение
 

Горизонтальная (x) и вертикальная (y) координаты мыши во время вызова текущего события. Эти координаты - относительно просматриваемой области документа.

 
Пример:

if ((event.clientX >= 10 || event.clientX <= 20) && (event.clientY >= 50 || event.clientY <= 100)) {
process code for click in hot zone bounded by 10,50 and 20,100
}

 
Возвращаемое значение:
Целое число of pixel values.
 
Значение по умолчанию: Ничего.

ctrlKey NN 6  IE 4   DOM 2
  Только чтение
 

Показывает состояние клавиши Alt во время обработки события (нажата ли). Следите за кросс-платформенной совместимостью.

 
Пример:

if (event.ctrlKey) { process for Control key being down

}

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

currentTarget NN 6  IE n/a  DOM 2
  Только чтение
 

Данное свойство задаёт ссылку на объект элемента, чей приёмник события выполняется в данный момент.

 
 
 
Возвращаемое значение:
Ссылка на объект элемента
 
Значение по умолчанию:  

data NN 4   IE n/a  DOM n/a
  Только чтение
 

Данные вспомогательной программы, связанные с событием. От Navigator 4, единственное событие, для которого работает свойство data - событие dragdrop , когда свойство data возвращает URL элемента, перетаскиваемого в окно или фрейм.

 
Пример:

var srcDoc = evtObj.data

 
Возвращаемое значение:
Строка.
 
Значение по умолчанию: Ничего.

dataTransfer NN n/a  IE 5(кроме IE5/Mac)  DOM n/a
  Только чтение
 

Данное свойство является ссылкой на объект dataTransfer. Можно использовать Этот объект в операциях перетаскивания. В таблице перечислены свойства и методы объекта dataTransfer.

Свойство/метод Синтаксис Возвращаемое значение Описание
dropEffect [window.]event.dataTransfer.dropEffect Строка Элемент, являющийся потенциальным приёмником отдельного действия, может использовать обработчики событий onDragEnter, onDragOver или onDrop для установки типа указателя, отображённого поверх элемента. Прежде, чем это сможет работать, обработчик события onDragStart элемента источника должен задать значения свойства eventEffectAllowed. Возможные строковые значения для обоих свойств - copy, link, move или none. Эти значения соответствуют системным указателям Windows, которые обычно используются при управлении файлами или документами. Следует также отменить действие по умолчанию (event.returnValue=false) для всех обработчиков события: onDragEnter, onDragOver и onDrop
effectAllowed [window.]event.dataTransfer.effectAllowed Строка Вызывается как реакция на событие DragStart элемента источника. Это свойство определяет тип действия перетаскивания, которое будет происходить. Copy, link, move или none - это возможные строковые значения. Значение должно соответствовать значению свойства dropEffect объекта event целевого объекта и отменять действия по умолчанию в обработчике onDragEvent.
clearData() [window.]event.dataTransfer.clearData([формат]) Нет Переносит данные в буфер обмена. Если данные не имеют форматирования, все они будут уничтожены. Параметр - одно или несколько значений: Text, URL, File, HTML, Image
GetData() [window.]event.dataTransfer.GetData(формат) Строка Извлекает данные из буфера обмена. Параметр - одно или несколько значений: Text, URL, File, HTML, Image. Операция не очищает буфер.
SetData() [window.]event.dataTransfer.SetData(формат, данные) Булево Доставляет данные в буфер обмена. Параметр - одно или несколько значений: Text, URL, File, HTML, Image. Второй параметр - URL содержимого. Метод возвращает true, если операция прошла успешно.
 
 
 
Возвращаемое значение:
Объект
 
Значение по умолчанию: Ничего.

detail NN 6  IE n/a  DOM 2
  Только чтение
 

Данное свойство включено в W3C DOM как дополнительное, цель которого может быть определена создателем броузера. В теории целочисленное значение может передавать дополнительную информацию о событии. На практике это свойство ничего не означает (но может, будет означать в будущем).

 
 
 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: Ничего.

eventPhase NN 6  IE n/a  DOM 2
  Только чтение
 

Событие постоянно находится в одной из 3 фаз. Свойство показывает, в какой фазе находится событие.

 
 
 
Возвращаемое значение:
Целочисленное: 1 - сбор данных; 2 - в целевом объекте; 3 - всплывание
 
Значение по умолчанию: Ничего.

fromElement NN n/a  IE 4   DOM n/a
  Только чтение
 

Возвращает ссылку на объект, где курсор был до события onMouseOver или onMouseOut .

 
Пример:

if (event.fromElement.id == "lowerLevel") { ... }

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

isChar NN 6  IE n/a  DOM 2
  Только чтение
 

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

 
 
 
Возвращаемое значение:
Булево
 
Значение по умолчанию:  

keyCode NN 6  IE 4   DOM 2
  Чтение/Изменение
 

Ключ Unicode для клавиши клавиатуры, которая вызвала событие. Для события onKeyPress значение представляет фактический символ, отображенный в текстовом поле (например, 65 для "A" и 97 для "a"). Но для событий onKeyDown и onKeyUp возвращается только значение верхний регистр, независимо от представленного символа. Если событие - не управляемое с клавиатуры, значение нулевое. В то время как Вы можете изменять значение этого свойства, это не влияет на символ, отображенный в текстовом поле..

 
Пример:

if (event.keyCode == 65) { ... }

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

layerX, layerY NN 4   IE n/a  DOM n/a
  Только чтение
 

Горизонтальная (x) и вертикальная (y) координаты мыши во время обработки события. Эти координаты относительны содержащего слоя. Если никакие слои или отображаемые элементы не были определены, как контрольная точка используется заданный по умолчанию слой документа и свойства таким образом становятся эквивалентными свойствам pageX и pageY .

 
Пример:

if ((evtObj.layerX >= 10 || evtObj.layerX <= 20) && (evtObj.layerY >= 50 || evtObj.layerY <= 100)) { process code for click in hot zone bounded by 10,50 and 20,100

}

 
Возвращаемое значение:
Целое число пикселв.
 
Значение по умолчанию: Ничего.

metaKey NN 6/Mac  IE n/a  DOM 2
  Только чтение
 

Показывает состояние клавиши <Command> (в Macintosh) во время обработки события

 
 
 
Возвращаемое значение:
Булево
 
Значение по умолчанию: Ничего.

modifiers NN 4   IE n/a  DOM n/a
 Только чтение
 

Целое число, которое представляет клавишу-модификатор клавиатуры, активированную или нет во время обработки события. Вы можете использовать оператор & между константами объекта Event, чтобы выяснить, была ли нажата определённая клавиша-модификатор.

 
Пример:

var altKeyPressed = evtObj.modifiers & Event.ALT_MASK

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: 0

nextPage NN n/a  IE 5.5(кроме IE5/Mac)  DOM n/a
  Только чтение
 

Свойство NextPage применяется в том случае, если документ в IE5.5/Windows использует поведение TemplatePrinter. К значениям этого свойства относятся left, right или пустая строка. Для получения информации о поведении TemplatePrinter исключительно для IE5.5 для Windows, посетите узел http://msdn.microsoft.com/workshop/browser/hosting/printpreview/reference/behaviors/TemplatePrinter.asp

 
 
 
Возвращаемое значение:
Строка
 
Значение по умолчанию: Ничего.

offsetX, offsetY NN n/a  IE 4   DOM n/a
 Только чтение
 

Левая и верхняя координаты указателя относительно содержащего контейнера когда обрабатывалось событие. Вы можете определять содержащий элемент через свойство offsetParent.

 
Пример:

if (event.offsetX <= 20 && event.offsetY <=40) { ... }

 
Возвращаемое значение:
Целое число пикселей.
 
Значение по умолчанию: Ничего.

pageX, pageY NN 4   IE n/a  DOM 2
  Только чтение
 

Левая и верхняя координаты элемента относительно верхнего левого угла страницы, во время обработки события. Размеры игнорируют любую прокрутку страницы

 
Пример:

if (evtObj.pageX <= 20 && evtObj.pageY <=40) { ... }

 
Возвращаемое значение:
Целое число пикселов.
 
Значение по умолчанию: Ничего.

propertyName NN n/a  IE 5(кроме IE5/Mac)  DOM n/a
  Только чтение
 

Свойство propertyName принимает значение свойства (только после возникновения события onPropertyChange).

 
 
 
Возвращаемое значение:
Строка
 
Значение по умолчанию: Ничего.

repeat NN n/a  IE 5(кроме IE5/Mac)  DOM n/a
  Только чтение
 

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

 
Пример:

if (event.repeat) { Event.returnValue=false }

 
Возвращаемое значение:
Булево
 
Значение по умолчанию: Ничего.

reason NN n/a  IE 4   DOM n/a
  Только чтение
 

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

 
Пример:

if (event.reason == 2) { alert("An error occurred during the most recent update.") }

 
Возвращаемое значение:
Одно из трёх значений:
0 Передача завершена успешно
1 Передача прервана
2 Ошибка при передаче
 
Значение по умолчанию: Ничего.

relatedTarget NN 6/Mac  IE n/a  DOM 2
  Только чтение
 

Позволяет выявить элементы, с которых наводится указатель мыши на текущий элемент и на он которые сводится с него.

 
 
 
Возвращаемое значение:
Объект элемента
 
Значение по умолчанию: Ничего.

returnValue NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Значение, которое будет возвращено элементу, вызвавшему событие, для того, чтобы позволить или запретить заданное по умолчанию действие элемента, связанное с событием. Если Вы устанавливаете event.returnValue в false, элемент не выполняет предназначенную для него операцию типа перехода по ссылке или передачи формы.

 
Пример:

event.returnValue = "false"

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: true

saveType NN n/a  IE 5.5  DOM n/a
  Только чтение
 

Свойство saveType приобретает значение, когда событие onContentSave привязывается к поведению IE/Windows, определяемому DHTML, (.htc). Для получения подробностей посетите http://msdn.microsoft.com/workshop/autor/behaviors/overview.asp

 
 
 
Возвращаемое значение:
Строка
 
Значение по умолчанию: true

screenX, screenY NN 4   IE 4   DOM 2
 Только чтение
 

Горизонтальная и вертикальная координаты точки, где был расположен курсор на мониторе во время обработки события. Верхний левый угол экрана - точка 0,0. Нет никакой связи с окном браузера.

 
Пример:

// NN if (evtObj.screenX < 5 || evtObj.screenY < 5) { alert("You\'re too close to the edge!") } // IE if (event.screenX < 5 || event.screenY < 5) { alert("You\'re too close to the edge!") }

 
Возвращаемое значение:
Целое положительное число или 0.
 
Значение по умолчанию: Ничего.

shiftKey NN 6  IE 4   DOM 2
 Только чтение
 

Показывает состояние клавиши SHIFT во время обработки события.

 
Пример:

if (event.shiftKey) { handle case of Shift key down

}

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

srcElement NN n/a  IE 4   DOM n/a
 Только чтение
 

Ссылка на элемент вызвавший текущее событие. Это свойство удобно в конструкциях "выключателя" для функции, вызываемой множеством различных элементов.

 
Пример:

switch (event.srcElement.id) { case myDIV: ... ... }

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

srcFilter NN n/a  IE 4   DOM n/a
  Только чтение
 

Ссылка на объект filter который вызвал событие onFilterChange. Это свойство удобно в конструкциях "выключателя" для функции, вызываемой множеством различных элементов.

 
Пример:

switch (event.srcFilter.id) { case myDIV: ... ... }

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

srcUrn NN n/a  IE 5(кроме IE5/Mac)  DOM n/a
  Только чтение
 

Свойство возвращает строку с URN-идентификатором поведения. Для получения подробностей посетите http://msdn.microsoft.com/workshop/autor/behaviors/overview.asp

 
 
 
Возвращаемое значение:
Строка
 
Значение по умолчанию: Ничего.

target NN 6  IE n/a  DOM 2
  Только чтение
 

Ссылка на элемент - цель текущего события. Это свойство удобно в конструкциях "выключателя" для функции, вызываемой множеством различных элементов.

 
Пример:

switch (evtObj.target.name) { case "myButton": ... ... }

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

timeStamp NN 6  IE n/a  DOM 2
  Только чтение
 

Время, прошедшее с 1 января 1970 года до момента возникновения события (в миллисекундах).

 
 
 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: Зависит от времени

toElement NN n/a  IE 4   DOM n/a
 Только чтение
 

Возвращает ссылку на объект который вызвал событие onMouseOut .

 
Пример:

if (event.toElement.id == "upperLevel") { ... }

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

type NN 4   IE 4   DOM n/a
  Только чтение
 

Тип текущего события (без префикса "on"). Все значения в нижнем регистре.

 
Пример:

// NN if (evtObj.type == "change") { ... } // IE if (event.type == "change") { ... }

 
Возвращаемое значение:
Любое имя события (без префикса "on") как строка.
 
Значение по умолчанию: Ничего.

view NN 6  IE n/a  DOM n/a
  Только чтение
 

Чем ближе модель W3C DOM приближается к объектным моделям броузеров, тем сильнее ощущается необходимость в специальном объекте, называемом объектом абстрактного вида (класс AbstractView). Единственное свойство этого объекта - ссылка на содержащийся в нём документ. Пользовательские события всегда происходят внутри этого объекта, что отражено в свойстве view объекта event. В NN6 оно возвращает ссылку на объект window, в котором происходит событие. Эта ссылка позволяет объекту события передаваться сценариям других структур, а эти сценарии могут получать доступ к объекту document окна целевого объекта.

 
 
 
Возвращаемое значение:
Ссылка на объект window.
 
Значение по умолчанию: Текущее окно.

which NN 4   IE n/a  DOM n/a
 Только чтение
 

Возвращает значение в соответствии с типом события. Для событий мыши значение свойства - целое число, указывающее, какая кнопка мыши использовалась (1 - левая кнопка; 3 - правая). Для событий клавиатуры значение свойства - целое число, соответствеющее кодировке ASCII символа клавиатуры.

 
Пример:

if (evtObj.which == 65) { ... }

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

x, y NN n/a  IE 4   DOM n/a
 Только чтение
 

Возвращаются горизонтальная и вертикальная координаты указателя во время события. Система координат является или видимым элементом типа layer, или элементом BODY. Если указатель был вне области документа, будет возвращено значение -1.

 
Пример:

if (event.x < 20 && event.y < 30) { ... }

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

Методы:


PreventDefault( ) NN 6  IE n/a   DOM n/a

Данный метод предотвращает совершение событием действия по умолчанию. Этод метод эквивалентен инструкции return false в NN4. И та, и другая запись работают в NN 6. Вызов данного метода равносилен присвоению свойству event.returnValue значения false в IE5+.

 
Возвращаемое значение
Ничего.
 
Параметры
Ничего.

stopPropagation( ) NN 6  IE n/a   DOM n/a
Данный метод предотвращает продвижение события вверх или вниз по иерархии элементов.
 
Возвращаемое значение
Ничего.
 
Параметры
Ничего.


HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека