JavaScript 参考手册 目录

HTML DOM 事件对象

在 Web 开发中，事件是用户与网页交互的重要方式之一。当用户执行某些操作时（比如点击按钮、鼠标移动等），就会触发相应的事件。在 JavaScript 中，我们可以通过事件对象来处理这些事件。

事件对象的属性和方法

事件对象是由浏览器自动生成的，它包含了一些属性和方法，用来获取事件相关的信息和对事件进行操作。下面是一些常用的事件对象属性和方法：

  • event.target：获取触发事件的目标元素
  • event.type：获取事件的类型
  • event.preventDefault()：阻止事件的默认行为
  • event.stopPropagation()：停止事件在 DOM 树中传播
  • event.clientX / event.clientY：获取鼠标相对于浏览器窗口的坐标
  • event.key：获取按下的键盘按键

事件类型

在 HTML DOM 中，有很多种不同类型的事件，比如点击事件、鼠标移动事件、键盘按下事件等。下面是一些常见的事件类型：

  • click：点击事件
  • mouseover：鼠标移入事件
  • keydown：键盘按下事件
  • submit：表单提交事件
  • load：页面加载完成事件

示例代码

-- -------------------- ---- -------
-- ------
-------------------------------------------------------- --------------- -
  ----------------------
  ------------------------ --------------
---

-- --------
------------------------------------------------------------ --------------- -
  -----------------------
  --------------------- -------------- ---------------
---

总结

通过事件对象，我们可以更加灵活地处理用户与网页的交互，实现更加丰富的交互效果。深入了解事件对象的属性和方法，可以帮助我们更好地掌握 JavaScript 开发中的事件处理机制。

事件对象

静态变量 描述 DOM
CAPTURING-PHASE 当前事件阶段为捕获阶段(1) 1
AT-TARGET 当前事件是目标阶段,在评估目标事件(1) 2
BUBBLING-PHASE 当前的事件为冒泡阶段 (3) 3
属性 描述 DOM
bubbles 返回布尔值，指示事件是否是起泡事件类型。 2
cancelable 返回布尔值，指示事件是否可拥可取消的默认动作。 2
currentTarget 返回其事件监听器触发该事件的元素。 2
eventPhase 返回事件传播的当前阶段。 2
target 返回触发此事件的元素（事件的目标节点）。 2
timeStamp 返回事件生成的日期和时间。 2
type 返回当前 Event 对象表示的事件的名称。 2
方法 描述 DOM
initEvent() 初始化新创建的 Event 对象的属性。 2
preventDefault() 通知浏览器不要执行与事件关联的默认动作。 2
stopPropagation() 不再派发事件。 2

目标事件对象

方法 描述 DOM
addEventListener() 允许在目标事件中注册监听事件(IE8 = attachEvent()) 2
dispatchEvent() 允许发送事件到监听器上 (IE8 = fireEvent()) 2
removeEventListener() 运行一次注册在事件目标上的监听事件(IE8 = detachEvent()) 2

事件监听对象

方法 描述 DOM
handleEvent() 把任意对象注册为事件处理程序 2

文档事件对象

方法 描述 DOM
createEvent() 2

鼠标/键盘事件对象

属性 描述 DOM
altKey 返回当事件被触发时，"ALT" 是否被按下。 2
button 返回当事件被触发时，哪个鼠标按钮被点击。 2
clientX 返回当事件被触发时，鼠标指针的水平坐标。 2
clientY 返回当事件被触发时，鼠标指针的垂直坐标。 2
ctrlKey 返回当事件被触发时，"CTRL" 键是否被按下。 2
Location 返回按键在设备上的位置 3
charCode 返回onkeypress事件触发键值的字母代码。 2
key 在按下按键时返回按键的标识符。 3
keyCode 返回onkeypress事件触发的键的值的字符代码，或者 onkeydown 或 onkeyup 事件的键的代码。 2
which 返回onkeypress事件触发的键的值的字符代码，或者 onkeydown 或 onkeyup 事件的键的代码。 2
metaKey 返回当事件被触发时，"meta" 键是否被按下。 2
relatedTarget 返回与事件的目标节点相关的节点。 2
screenX 返回当某个事件被触发时，鼠标指针的水平坐标。 2
screenY 返回当某个事件被触发时，鼠标指针的垂直坐标。 2
shiftKey 返回当事件被触发时，"SHIFT" 键是否被按下。 2
方法 描述 W3C
initMouseEvent() 初始化鼠标事件对象的值 2
initKeyboardEvent() 初始化键盘事件对象的值 3
鼠标事件 描述 DOM
onclick 当用户点击某个对象时调用的事件句柄。 2
oncontextmenu 在用户点击鼠标右键打开上下文菜单时触发
ondblclick 当用户双击某个对象时调用的事件句柄。 2
onmousedown 鼠标按钮被按下。 2
onmouseenter 当鼠标指针移动到元素上时触发。 2
onmouseleave 当鼠标指针移出元素时触发 2
onmousemove 鼠标被移动。 2
onmouseover 鼠标移到某元素之上。 2
onmouseout 鼠标从某元素移开。 2
onmouseup 鼠标按键被松开。 2
键盘事件 描述 DOM
onkeydown 某个键盘按键被按下。 2
onkeypress 某个键盘按键被按下并松开。 2
onkeyup 某个键盘按键被松开。 2
框架/对象（Frame/Object）事件 描述 DOM
onabort 图像的加载被中断。 2
onbeforeunload 该事件在即将离开页面（刷新或关闭）时触发 2
onerror 在加载文档或图像时发生错误。
onhashchange 该事件在当前 URL 的锚部分发生修改时触发。
onload 一张页面或一幅图像完成加载。 2
onpageshow 该事件在用户访问页面时触发
onpagehide 该事件在用户离开当前网页跳转到另外一个页面时触发
onresize 窗口或框架被重新调整大小。 2
onscroll 当文档被滚动时发生的事件。 2
onunload 用户退出页面。 2
表单事件 描述 DOM
onblur 元素失去焦点时触发 2
onchange 该事件在表单元素的内容改变时触发 2
onfocus 元素获取焦点时触发 2
onfocusin 元素即将获取焦点时触发 2
onfocusout 元素即将失去焦点时触发 2
oninput 元素获取用户输入时触发 3
onreset 表单重置时触发 2
onsearch 用户向搜索域输入文本时触发
onselect 用户选取文本时触发 2
onsubmit 表单提交时触发 2
剪贴板事件 描述 DOM
oncopy 该事件在用户拷贝元素内容时触发
oncut 该事件在用户剪切元素内容时触发
onpaste 该事件在用户粘贴元素内容时触发
打印事件 描述 DOM
onafterprint 该事件在页面已经开始打印，或者打印窗口已经关闭时触发
onbeforeprint 该事件在页面即将开始打印时触发
拖动事件 描述 DOM
ondrag 该事件在元素正在拖动时触发
ondragend 该事件在用户完成元素的拖动时触发
ondragenter 该事件在拖动的元素进入放置目标时触发
ondragleave 该事件在拖动元素离开放置目标时触发
ondragover 该事件在拖动元素在放置目标上时触发
ondragstart 该事件在用户开始拖动元素时触发
ondrop 该事件在拖动元素放置在目标区域时触发
多媒体（Media）事件 描述 DOM
onabort 事件在视频/音频（audio/video）终止加载时触发。
oncanplay 事件在用户可以开始播放视频/音频（audio/video）时触发。
oncanplaythrough 事件在视频/音频（audio/video）可以正常播放且无需停顿和缓冲时触发。
ondurationchange 事件在视频/音频（audio/video）的时长发生变化时触发。
onemptied 当期播放列表为空时触发
onended 事件在视频/音频（audio/video）播放结束时触发。
onerror 事件在视频/音频（audio/video）数据加载期间发生错误时触发。
onloadeddata 事件在浏览器加载视频/音频（audio/video）当前帧时触发触发。
onloadedmetadata 事件在指定视频/音频（audio/video）的元数据加载后触发。
onloadstart 事件在浏览器开始寻找指定视频/音频（audio/video）触发。
onpause 事件在视频/音频（audio/video）暂停时触发。
onplay 事件在视频/音频（audio/video）开始播放时触发。
onplaying 事件在视频/音频（audio/video）暂停或者在缓冲后准备重新开始播放时触发。
onprogress 事件在浏览器下载指定的视频/音频（audio/video）时触发。
onratechange 事件在视频/音频（audio/video）的播放速度发送改变时触发。
onseeked 事件在用户重新定位视频/音频（audio/video）的播放位置后触发。
onseeking 事件在用户开始重新定位视频/音频（audio/video）时触发。
onstalled 事件在浏览器获取媒体数据，但媒体数据不可用时触发。
onsuspend 事件在浏览器读取媒体数据中止时触发。
ontimeupdate 事件在当前的播放位置发送改变时触发。
onvolumechange 事件在音量发生改变时触发。
onwaiting 事件在视频由于要播放下一帧而需要缓冲时触发。
动画事件 描述 DOM
animationend 该事件在 CSS 动画结束播放时触发
animationiteration 该事件在 CSS 动画重复播放时触发
animationstart 该事件在 CSS 动画开始播放时触发
过渡事件 描述 DOM
transitionend 该事件在 CSS 完成过渡后触发。
其他事件 描述 DOM
onmessage 该事件通过或者从对象(WebSocket, Web Worker, Event Source 或者子 frame 或父窗口)接收到消息时触发
onmousewheel onwheel
ononline 该事件在浏览器开始在线工作时触发。
onoffline 该事件在浏览器开始离线工作时触发。
onpopstate 该事件在窗口的浏览历史（history 对象）发生改变时触发。
onshow 该事件当 menu 元素在上下文菜单显示时触发
onstorage 该事件在 Web Storage(HTML 5 Web 存储)更新时触发
ontoggle 该事件在用户打开或关闭 details 元素时触发
onwheel 该事件在鼠标滚轮在元素上下滚动时触发
visibilitychange 该事件用于检测当前页面的可见性状态是否发生变化。
上一篇： HTML DOM 属性对象
下一篇： HTML DOM Console 对象
纠错
反馈