HTML DOM事件-工具盒子

HTML DOM 事件允许Javascript在HTML文档元素中注册不同事件处理程序。

鼠标事件 {#%E9%BC%A0%E6%A0%87%E4%BA%8B%E4%BB%B6}

| 属性 | 描述 | DOM | |---------------|---------------------|-----| | onclick | 当用户点击某个对象时调用的事件句柄。 | 2 | | oncontextmenu | 在用户点击鼠标右键打开上下文菜单时触发 | | | ondblclick | 当用户双击某个对象时调用的事件句柄。 | 2 | | onmousedown | 鼠标按钮被按下。 | 2 | | onmouseenter | 当鼠标指针移动到元素上时触发。 | 2 | | onmouseleave | 当鼠标指针移出元素时触发 | 2 | | onmousemove | 鼠标被移动。 | 2 | | onmouseover | 鼠标移到某元素之上。 | 2 | | onmouseout | 鼠标从某元素移开。 | 2 | | onmouseup | 鼠标按键被松开。 | 2 |

键盘事件 {#%E9%94%AE%E7%9B%98%E4%BA%8B%E4%BB%B6}

| 属性 | 描述 | DOM | |------------|---------------|-----| | onkeydown | 某个键盘按键被按下。 | 2 | | onkeypress | 某个键盘按键被按下并松开。 | 2 | | onkeyup | 某个键盘按键被松开。 | 2 |

框架/对象（Frame/Object）事件 {#%E6%A1%86%E6%9E%B6%2F%E5%AF%B9%E8%B1%A1%EF%BC%88frame%2Fobject%EF%BC%89%E4%BA%8B%E4%BB%B6}

| 属性 | 描述 | DOM | |----------------|------------------------------------------------------|--------| | onabort | 图像的加载被中断。 ( <object>) | 2 | | onbeforeunload | 该事件在即将离开页面（刷新或关闭）时触发 | 2 | | onerror | 在加载文档或图像时发生错误。 ( <object>, <body>和 <frameset>) | | | onhashchange | 该事件在当前 URL 的锚部分发生修改时触发。 | | | onload | 一张页面或一幅图像完成加载。 | 2 | | onpageshow | 该事件在用户访问页面时触发 |
| | onpagehide | 该事件在用户离开当前网页跳转到另外一个页面时触发 |
| | onresize | 窗口或框架被重新调整大小。 | 2 | | onscroll | 当文档被滚动时发生的事件。 | 2 | | onunload | 用户退出页面。 ( <body> 和 <frameset>) | 2 |

表单事件 {#%E8%A1%A8%E5%8D%95%E4%BA%8B%E4%BB%B6}

| 属性 | 描述 | DOM | |------------|----------------------------------------------------------------------|-----| | onblur | 元素失去焦点时触发 | 2 | | onchange | 该事件在表单元素的内容改变时触发( <input>, <keygen>, <select>, 和 <textarea>) | 2 | | onfocus | 元素获取焦点时触发 | 2 | | onfocusin | 元素即将获取焦点时触发 | 2 | | onfocusout | 元素即将失去焦点时触发 | 2 | | oninput | 元素获取用户输入时触发 | 3 | | onreset | 表单重置时触发 | 2 | | onsearch | 用户向搜索域输入文本时触发 ( <input="search">) | | | onselect | 用户选取文本时触发 ( <input> 和 <textarea>) | 2 | | onsubmit | 表单提交时触发 | 2 |

剪贴板事件 {#%E5%89%AA%E8%B4%B4%E6%9D%BF%E4%BA%8B%E4%BB%B6}

| 属性 | 描述 | DOM | |---------|-----------------|-----| | oncopy | 该事件在用户拷贝元素内容时触发 | | | oncut | 该事件在用户剪切元素内容时触发 | | | onpaste | 该事件在用户粘贴元素内容时触发 | |

打印事件 {#%E6%89%93%E5%8D%B0%E4%BA%8B%E4%BB%B6}

| 属性 | 描述 | DOM | |---------------|----------------------------|-----| | onafterprint | 该事件在页面已经开始打印，或者打印窗口已经关闭时触发 | | | onbeforeprint | 该事件在页面即将开始打印时触发 | |

拖动事件 {#%E6%8B%96%E5%8A%A8%E4%BA%8B%E4%BB%B6}

| 事件 | 描述 | DOM | |-------------|--------------------|-----| | ondrag | 该事件在元素正在拖动时触发 | | | ondragend | 该事件在用户完成元素的拖动时触发 | | | ondragenter | 该事件在拖动的元素进入放置目标时触发 | | | ondragleave | 该事件在拖动元素离开放置目标时触发 | | | ondragover | 该事件在拖动元素在放置目标上时触发 | | | ondragstart | 该事件在用户开始拖动元素时触发 | | | ondrop | 该事件在拖动元素放置在目标区域时触发 | |

多媒体（Media）事件 {#%E5%A4%9A%E5%AA%92%E4%BD%93%EF%BC%88media%EF%BC%89%E4%BA%8B%E4%BB%B6}

| 事件 | 描述 | 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 | 事件在视频由于要播放下一帧而需要缓冲时触发。 | |

动画事件 {#%E5%8A%A8%E7%94%BB%E4%BA%8B%E4%BB%B6}

| 事件 | 描述 | DOM | |--------------------|--------------------|-----| | animationend | 该事件在 CSS 动画结束播放时触发 | | | animationiteration | 该事件在 CSS 动画重复播放时触发 | | | animationstart | 该事件在 CSS 动画开始播放时触发 | |

过渡事件 {#%E8%BF%87%E6%B8%A1%E4%BA%8B%E4%BB%B6}

| 事件 | 描述 | DOM | |---------------|-------------------|-----| | transitionend | 该事件在 CSS 完成过渡后触发。 | |

其他事件 {#%E5%85%B6%E4%BB%96%E4%BA%8B%E4%BB%B6}

| 事件 | 描述 | 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 | 该事件用于检测当前页面的可见性状态是否发生变化。 | |

事件对象 {#%E4%BA%8B%E4%BB%B6%E5%AF%B9%E8%B1%A1}

常量 {#%E5%B8%B8%E9%87%8F}

| 静态变量 | 描述 | DOM | |-----------------|----------------------|-----| | CAPTURING-PHASE | 当前事件阶段为捕获阶段(1) | 1 | | AT-TARGET | 当前事件是目标阶段,在评估目标事件(1) | 2 | | BUBBLING-PHASE | 当前的事件为冒泡阶段 (3) | 3 |

属性 {#%E5%B1%9E%E6%80%A7}

| 属性 | 描述 | DOM | |---------------|-------------------------|-----| | bubbles | 返回布尔值，指示事件是否是起泡事件类型。 | 2 | | cancelable | 返回布尔值，指示事件是否可拥可取消的默认动作。 | 2 | | currentTarget | 返回其事件监听器触发该事件的元素。 | 2 | | eventPhase | 返回事件传播的当前阶段。 | 2 | | target | 返回触发此事件的元素（事件的目标节点）。 | 2 | | timeStamp | 返回事件生成的日期和时间。 | 2 | | type | 返回当前 Event 对象表示的事件的名称。 | 2 |

方法 {#%E6%96%B9%E6%B3%95}

| 方法 | 描述 | DOM | |-------------------|----------------------|-----| | initEvent() | 初始化新创建的 Event 对象的属性。 | 2 | | preventDefault() | 通知浏览器不要执行与事件关联的默认动作。 | 2 | | stopPropagation() | 不再派发事件。 | 2 |

目标事件对象 {#%E7%9B%AE%E6%A0%87%E4%BA%8B%E4%BB%B6%E5%AF%B9%E8%B1%A1}

方法 {#%E6%96%B9%E6%B3%95-1}

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

事件监听对象 {#%E4%BA%8B%E4%BB%B6%E7%9B%91%E5%90%AC%E5%AF%B9%E8%B1%A1}

方法 {#%E6%96%B9%E6%B3%95-2}

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

文档事件对象 {#%E6%96%87%E6%A1%A3%E4%BA%8B%E4%BB%B6%E5%AF%B9%E8%B1%A1}

方法 {#%E6%96%B9%E6%B3%95-3}

| 方法 | 描述 | DOM | |---------------|----|-----| | createEvent() | | 2 |

鼠标/键盘事件对象 {#%E9%BC%A0%E6%A0%87%2F%E9%94%AE%E7%9B%98%E4%BA%8B%E4%BB%B6%E5%AF%B9%E8%B1%A1}

属性 {#%E5%B1%9E%E6%80%A7-1}

| 属性 | 描述 | 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 |