跳到主要内容

HTML 事件属性


全局事件属性

HTML 4 的新特性之一是可以使 HTML 事件触发浏览器中的行为,比方说当用户点击某个 HTML 元素时启动一段 JavaScript。

如果你想学习更多关于事件属性,请访问 JavaScript 教程

下面的表格提供了标准的事件属性,可以把它们插入 HTML/XHTML 元素中,以定义事件行为。

🆕 : HTML5 新增属性事件。


窗口事件属性(Window Event Attributes)

由窗口触发该事件 (适用于 <body> 标签):

属性描述
onafterprint🆕script在打印文档之后运行脚本
onbeforeprint🆕script在文档打印之前运行脚本
onbeforeonload🆕script在文档加载之前运行脚本
onblurscript当窗口失去焦点时运行脚本
onerror🆕script当错误发生时运行脚本
onfocusscript当窗口获得焦点时运行脚本
onhashchange🆕script当文档改变时运行脚本
onloadscript当文档加载时运行脚本
onmessage🆕script当触发消息时运行脚本
onoffline🆕script当文档离线时运行脚本
ononline🆕script当文档上线时运行脚本
onpagehide🆕script当窗口隐藏时运行脚本
onpageshow🆕script当窗口可见时运行脚本
onpopstate🆕script当窗口历史记录改变时运行脚本
onredo🆕script当文档执行再执行操作(redo)时运行脚本
onresize🆕script当调整窗口大小时运行脚本
onstorage🆕script当 Web Storage 区域更新时(存储空间中的数据发生变化时)运行脚本
onundo🆕script当文档执行撤销时运行脚本
onunload🆕script当用户离开文档时运行脚本

表单事件(Form Events)

表单事件在HTML表单中触发 (适用于所有 HTML 元素, 但该HTML元素需在 form 表单内):

属性描述
onblurscript当元素失去焦点时运行脚本
onchangescript当元素改变时运行脚本
oncontextmenu🆕script当触发上下文菜单时运行脚本
onfocusscript当元素获得焦点时运行脚本
onformchange🆕script当表单改变时运行脚本
onforminput🆕script当表单获得用户输入时运行脚本
oninput🆕script当元素获得用户输入时运行脚本
oninvalid🆕script当元素无效时运行脚本
onresetscript当表单重置时运行脚本。HTML5 不支持。
onselectscript当选取元素时运行脚本
onsubmitscript当提交表单时运行脚本

键盘事件(Keyboard Events)

属性描述
onkeydownscript当按下按键时运行脚本
onkeypressscript当按下并松开按键时运行脚本
onkeyupscript当松开按键时运行脚本

鼠标事件(Mouse Events)

通过鼠标触发事件, 类似用户的行为:

属性描述
onclickscript当单击鼠标时运行脚本
ondblclickscript当双击鼠标时运行脚本
ondrag🆕script当拖动元素时运行脚本
ondragend🆕script当拖动操作结束时运行脚本
ondragenter🆕script当元素被拖动至有效的拖放目标时运行脚本
ondragleave🆕script当元素离开有效拖放目标时运行脚本
ondragover🆕script当元素被拖动至有效拖放目标上方时运行脚本
ondragstart🆕script当拖动操作开始时运行脚本
ondrop🆕script当被拖动元素正在被拖放时运行脚本
onmousedownscript当按下鼠标按钮时运行脚本
onmousemovescript当鼠标指针移动时运行脚本
onmouseoutscript当鼠标指针移出元素时运行脚本
onmouseoverscript当鼠标指针移至元素之上时运行脚本
onmouseupscript当松开鼠标按钮时运行脚本
onmousewheel🆕script当转动鼠标滚轮时运行脚本
onscroll🆕script当滚动元素的滚动条时运行脚本

多媒体事件(Media Events)

通过视频(videos),图像(images)或者音频(audio) 触发该事件,多应用于 HTML 媒体元素比如 <audio>, <embed>, <img>, <object>, 和 <video>:

属性描述
onabortscript当发生中止事件时运行脚本
oncanplay🆕script当媒介能够开始播放但可能因缓冲而需要停止时运行脚本
oncanplaythrough🆕script当媒介能够无需因缓冲而停止即可播放至结尾时运行脚本
ondurationchange🆕script当媒介长度改变时运行脚本
onemptied🆕script当媒介资源元素突然为空时(网络错误、加载错误等)运行脚本
onended🆕script当媒介已抵达结尾时运行脚本
onerror🆕script当在元素加载期间发生错误时运行脚本
onloadeddata🆕script当加载媒介数据时运行脚本
onloadedmetadata🆕script当媒介元素的持续时间以及其他媒介数据已加载时运行脚本
onloadstart🆕script当浏览器开始加载媒介数据时运行脚本
onpause🆕script当媒介数据暂停时运行脚本
onplay🆕script当媒介数据将要开始播放时运行脚本
onplaying🆕script当媒介数据已开始播放时运行脚本
onprogress🆕script当浏览器正在取媒介数据时运行脚本
onratechange🆕script当媒介数据的播放速率改变时运行脚本
onreadystatechange🆕script当就绪状态(ready-state)改变时运行脚本
onseeked🆕script当媒介元素的定位属性 [1] 不再为真且定位已结束时运行脚本
onseeking🆕script当媒介元素的定位属性为真且定位已开始时运行脚本
onstalled🆕script当取回媒介数据过程中(延迟)存在错误时运行脚本
onsuspend🆕script当浏览器已在取媒介数据但在取回整个媒介文件之前停止时运行脚本
ontimeupdate🆕script当媒介改变其播放位置时运行脚本
onvolumechange🆕script当媒介改变音量亦或当音量被设置为静音时运行脚本
onwaiting🆕script当媒介已停止播放但打算继续播放时运行脚本

其他事件

属性描述
onshow🆕script<menu> 元素在上下文显示时触发
ontoggle🆕script当用户打开或关闭 <details> 元素时触发