event | NN 4 IE 4 DOM 2 | ||||
Объект event содержит информацию о пользовательских и системных событиях. В Navigator и Internet Explorer механизмы event весьма различны. За редким исключением, свойства объекта event для этих двух браузеров взаимоисключающие. Тщательно следите за совместимостью. | |||||
Объектно-ориентированная модель (см.
Модели событий - Ссылки на объект
события)
|
Свойства:
altKey | NN 6 IE 4 DOM 2 | ||
Только чтение | |||
Показывает состояние клавиши Alt во время обработки события. |
|||
Пример:
if (event.altKey) { |
|||
Возвращаемое значение: Булево значение: true | false. |
|||
|
altLeft, ctrlLeft, shiftLeft | NN n/a IE 5.5 DOM n/a | ||
Только чтение | |||
Некоторые версии Windows во время использования IE5+ позволяют модифицировать события только с помощью левых клавиш-модификаторов. Свойства показывают нажатость именно левых клавиш. |
|||
Возвращаемое значение: Булево значение: true | 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:
|
|||||||||||||||||||||||||||||
Возвращаемое значение: См. текст |
|||||||||||||||||||||||||||||
|
button | NN 6 IE 4 DOM 2 | ||
Только чтение | |||
Какая кнопка мыши была нажата, чтобы вызвать событие. Хотя теоретически Вы способны обнаружить кнопку right, Internet Explorer 4 не обрабатывает события мыши с правой кнопкой, так как она служит для контекстного меню. |
|||
Пример:
if (event.button == 1) { |
|||
Возвращаемое значение: Любое из следующих целых чисел: 0 (нет кнопки) | 1 (левая) | 2 (правая) | 4 (средняя). |
|||
|
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. |
|||
|
cancelable | NN 6 IE 4 DOM 2 | ||
Чтение/Изменение | |||
Свойство показывает, можно ли отменять данное событие. |
|||
Возвращаемое значение: Булево значение: true | 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)) { | |||
Возвращаемое значение: Целое число of pixel values. | |||
|
ctrlKey | NN 6 IE 4 DOM 2 | ||
Только чтение | |||
Показывает состояние клавиши Alt во время обработки события (нажата ли). Следите за кросс-платформенной совместимостью. |
|||
Пример:
if (event.ctrlKey) { } |
|||
Возвращаемое значение: Булево значение: true | 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.
|
|||||||||||||||||||||||||
Возвращаемое значение: Объект |
|||||||||||||||||||||||||
|
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)) { } |
|||
Возвращаемое значение: Целое число пикселв. |
|||
|
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 | |||
Возвращаемое значение: Целое число. | |||
|
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.") } |
|||||||
Возвращаемое значение: Одно из трёх значений:
|
|||||||
|
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. |
|||
|
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 |
|||
Возвращаемое значение: Строка |
|||
|
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) { } | |||
Возвращаемое значение: Булево значение: true | 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! |