分类：事件对象

jQuery 的事件系统根据 W3C 标准规范化事件对象。事件对象保证会传递给事件处理程序。原始事件的大多数属性都被复制并规范化到新的事件对象中。

jQuery.Event 构造函数

jQuery.Event 构造函数已公开，可在调用 trigger 时使用。new 运算符是可选的。

查看 trigger 的文档，了解如何将其与您自己的事件对象结合使用。

示例

1
2
3
4
5
 
//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() 传递一个对象，其属性将设置在新创建的 Event 对象上。

示例

1
2
3
4
5
 
// 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 对象

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

event.data

当绑定当前执行的处理程序时，传递给事件方法的额外数据对象。

event.pageX

鼠标相对于文档左边缘的位置。

event.pageY

鼠标相对于文档上边缘的位置。

event.result

由此事件触发的事件处理程序返回的最后一个值，除非该值为 undefined。

event.stopPropagation()

阻止事件在 DOM 树中冒泡，从而阻止任何父级处理程序收到事件通知。

event.timeStamp

浏览器创建事件的时间与 1970 年 1 月 1 日之间的毫秒差。

event.which

对于键盘或鼠标事件，此属性指示被按下的特定键或按钮。