Spec-Zone.ru › jQuery

Категория: Объект события

Система событий jQuery нормализует объект события в соответствии со стандартами W3C. Объект события гарантированно передается обработчику событий. Большинство свойств из исходного события копируются и нормализуются в новый объект события.

Конструктор jQuery.Event

Конструктор jQuery.Event доступен и может использоваться при вызове trigger. Оператор new является необязательным.

Проверьте документацию trigger, чтобы узнать, как использовать его с собственным объектом события.

Пример:

//Create a new jQuery.Event object without the "new" operator.
var e = jQuery.Event( "click" );
 
// trigger an artificial click event
jQuery( "body" ).trigger( e );

Начиная с jQuery 1.6, вы также можете передать объект в jQuery.Event(), и его свойства будут установлены в новом объекте события.

Пример:

// Create a new jQuery.Event object with specified event properties.
var e = jQuery.Event( "keydown", { keyCode: 64 } );
 
// trigger an artificial keydown event with keyCode 64
jQuery( "body" ).trigger( e );

Общие свойства события

jQuery нормализует следующие свойства для обеспечения кроссбраузерной совместимости:

  • target
  • relatedTarget
  • pageX
  • pageY
  • which
  • metaKey

Следующие свойства также копируются в объект события, хотя некоторые из их значений могут быть неопределёнными в зависимости от события:

altKey, bubbles, button, buttons, cancelable, char, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, key, keyCode, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, relatedTarget, screenX, screenY, shiftKey, target, toElement, view, which

Другие свойства

Для доступа к свойствам события, не перечисленным выше, используйте объект event.originalEvent:

// Access the `dataTransfer` property from the `drop` event which
// holds the files dropped into the browser window.
var files = event.originalEvent.dataTransfer.files;

event.currentTarget

Текущий элемент DOM в фазе распространения события.

event.data

Необязательный объект данных, переданный методу события при связывании текущего обработчика.

event.delegateTarget

Элемент, к которому был присоединён текущий обработчик событий jQuery.

event.isDefaultPrevented()

Возвращает, был ли вызван event.preventDefault() для этого объекта события.

event.isImmediatePropagationStopped()

Возвращает, был ли вызван event.stopImmediatePropagation() для этого объекта события.

event.isPropagationStopped()

Возвращает, был ли вызван event.stopPropagation() для этого объекта события.

event.metaKey

Указывает, была ли нажата клавиша META при возникновении события.

event.namespace

Пространство имён, указанное при запуске события.

event.pageX

Положение курсора относительно левого края документа.

event.pageY

Положение курсора относительно верхнего края документа.

END_OF_DOCUMENT_MARKER

event.preventDefault()

Если этот метод вызывается, стандартное действие события не будет выполнено.

event.relatedTarget

Другой элемент DOM, участвующий в событии, если таковой имеется.

event.result

Последнее значение, возвращённое обработчиком события, который был вызван этим событием, если значение не было undefined.

event.stopImmediatePropagation()

Препятствует выполнению остальных обработчиков и предотвращает распространение события вверх по дереву DOM.

event.stopPropagation()

Препятствует распространению события вверх по дереву DOM, предотвращая уведомление любых родительских обработчиков о событии.

event.target

Элемент DOM, инициировавший событие.

event.timeStamp

Разница в миллисекундах между временем создания события браузером и 1 января 1970 года.

event.type

Описывает характер события.

event.which

Для событий клавиатуры или мыши эта свойство указывает на конкретную нажатую клавишу или кнопку.

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/category/events/event-object

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API