Свойства и методы объекта Event в jQuery
Объект event в jquery отличается от объекта event в javascript наличием дополнительных свойств и методов, а также кроссбраузерной совместимостью.
| Свойство/Метод | Описание | Возвращаемое значение |
|---|---|---|
currentTarget
|
Возвращает текущий DOM-элемент, событие которого обрабатывается. Внутри обработчика всегда совпадает с this. Этот элемент не всегда является источником события, поскольку оно могло быть передано от дочернего элемента, посредством механизма "всплытия" события вверх по иерархии DOM.Равнозначно this, поэтому кажется ненужным, но иногда гораздо удобнее получить текущий элемент из объекта события.
|
HTMLElement |
pageX
|
Координаты указателя мышки относительно левого верхнего угла документа. | number |
pageY
|
Координаты указателя мышки относительно левого верхнего угла документа. | number |
preventDefault()
|
Отменяем действие по умолчанию, связанное с текущим событием. |
void (аннулируем) |
relatedTarget
|
Для событий мыши возвращает другой (не текущий) DOM-элемент, участвующий в событии. Например, для события mouseout
будет содержать элемент, куда переместился курсор, а для mousein элемент, откуда курсор пришел.
|
HTMLElement |
isDefaultPrevented()
|
Возвратит true, если для объекта событий уже был вызван метод preventDefault()
|
boolean |
type
|
Возвращает тип события | string |
target
|
Возвращает DOM-элемент, являющийся источником события. То есть это самый глубокий (вложенный) элемент, который вызывает событие |
HTMLElement |
timeStamp
|
Возвращает время (колч-во сек., прошедших с 1.01.1970) наступления события | number |
stopImmediatePropagation()
|
Предотвращает выполнение следующих обработчиков, связанных с данным событием | void |
isImmediatePropagationStopped()
|
Возвратит true, если для данного объекта событий уже был вызван метод stopImmediatePropagation()
|
boolean |
stopPropagation()
|
Предотвращает всплытие события вверх по иерархии дерева DOM.
(некоторые события, такие как click, после выполнения на самом элементе, будут всплывать до <HTML>, а затем и до document, при этом вызывая все обработчики на своем пути)
|
void |
isPropagationStopped()
|
Возвратит true, если для данного объекта событий уже был вызван метод stopPropagation()
|
boolean |
data
|
Данные (переданные методу bind()), которые передаются обработчику при его установке.
* (примеры см. ниже)
|
object |
result
|
Результат, который возвратил предыдущий обработчик этого события. | object |
which
|
Возвращает кроссбраузерную информацию о нажатой кнопке | number |
*
$('.test').bind('click', {msg:'Me click'}, function(e){
alert(e.data.msg);
});
* или:
$('.test').bind('click', 'Me click', function(e){
alert(e.data);
});

Комментарии к статье