Свойства и методы объекта 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);
});
Комментарии к статье