HTML 事件属性
全局事件属性
HTML 能够让事件在浏览器中触发操作,例如在用户点击元素时启动 JavaScript。
要了解更多关于编程事件的信息,请访问我们的 JavaScript 教程。
以下是可以添加到 HTML 元素以定义事件操作的全局事件属性。
窗口事件属性
为窗口对象触发的事件(适用于 <body> 标签)
属性 | 值 | 描述 |
---|---|---|
onafterprint | 脚本 | 在文档打印后要运行的脚本 |
onbeforeprint | 脚本 | 在文档打印之前要运行的脚本 |
onbeforeunload | 脚本 | 在文档即将卸载时要运行的脚本 |
onerror | 脚本 | 发生错误时要运行的脚本 |
onhashchange | 脚本 | 当 URL 的锚部分发生变化时要运行的脚本 |
onload | 脚本 | 页面加载完毕后触发 |
onmessage | 脚本 | 当消息触发时要运行的脚本 |
onoffline | 脚本 | 当浏览器开始离线工作时要运行的脚本 |
ononline | 脚本 | 当浏览器开始在线工作时要运行的脚本 |
onpagehide | 脚本 | 当用户离开页面时要运行的脚本 |
onpageshow | 脚本 | 当用户导航到页面时要运行的脚本 |
onpopstate | 脚本 | 当窗口的历史记录发生变化时要运行的脚本 |
onresize | 脚本 | 浏览器窗口大小调整时触发 |
onstorage | 脚本 | 更新 Web 存储区域时要运行的脚本 |
onunload | 脚本 | 页面卸载(或浏览器窗口关闭)后触发 |
表单事件
由 HTML 表单内部操作触发的事件(适用于几乎所有 HTML 元素,但最常用于表单元素)
属性 | 值 | 描述 |
---|---|---|
onblur | 脚本 | 元素失去焦点时触发 |
onchange | 脚本 | 元素的值发生变化时触发 |
oncontextmenu | 脚本 | 当上下文菜单触发时要运行的脚本 |
onfocus | 脚本 | 元素获得焦点时触发 |
oninput | 脚本 | 当元素获得用户输入时要运行的脚本 |
oninvalid | 脚本 | 当元素无效时要运行的脚本 |
onreset | 脚本 | 表单中的重置按钮被点击时触发 |
onsearch | 脚本 | 当用户在搜索字段中输入内容时触发(对于 <input="search">) |
onselect | 脚本 | 在元素中选择了一些文本后触发 |
onsubmit | 脚本 | 表单提交时触发 |
键盘事件
属性 | 值 | 描述 |
---|---|---|
onkeydown | 脚本 | 用户按下键时触发 |
onkeypress | 脚本 | 用户按下键时触发 |
onkeyup | 脚本 | 用户释放键时触发 |
鼠标事件
属性 | 值 | 描述 |
---|---|---|
onclick | 脚本 | 鼠标点击元素时触发 |
ondblclick | 脚本 | 鼠标双击元素时触发 |
onmousedown | 脚本 | 鼠标按钮按下元素时触发 |
onmousemove | 脚本 | 鼠标指针在元素上移动时触发 |
onmouseout | 脚本 | 鼠标指针移出元素时触发 |
onmouseover | 脚本 | 鼠标指针移入元素时触发 |
onmouseup | 脚本 | 鼠标按钮释放元素时触发 |
onmousewheel | 脚本 | 已弃用。 请使用 onwheel 属性代替 |
onwheel | 脚本 | 鼠标滚轮在元素上滚动时触发 |
拖动事件
属性 | 值 | 描述 |
---|---|---|
ondrag | 脚本 | 拖动元素时要运行的脚本 |
ondragend | 脚本 | 拖动操作结束时要运行的脚本 |
ondragenter | 脚本 | 当元素被拖动到有效的放置目标时要运行的脚本 |
ondragleave | 脚本 | 当元素离开有效的放置目标时要运行的脚本 |
ondragover | 脚本 | 元素被拖动到有效的放置目标时运行的脚本 |
ondragstart | 脚本 | 拖动操作开始时运行的脚本 |
ondrop | 脚本 | 拖动元素被放置时运行的脚本 |
onscroll | 脚本 | 元素的滚动条被滚动时运行的脚本 |
剪贴板事件
属性 | 值 | 描述 |
---|---|---|
oncopy | 脚本 | 当用户复制元素内容时触发 |
oncut | 脚本 | 当用户剪切元素内容时触发 |
onpaste | 脚本 | 当用户将内容粘贴到元素中时触发 |
媒体事件
由媒体(如视频、图像和音频)触发的事件(适用于所有 HTML 元素,但在媒体元素(如 <audio>、<embed>、<img>、<object> 和 <video>)中最为常见)。
提示:有关更多信息,请查看我们的 HTML 音频和视频 DOM 参考。
属性 | 值 | 描述 |
---|---|---|
onabort | 脚本 | 在中止时运行的脚本 |
oncanplay | 脚本 | 当文件准备好开始播放时运行的脚本(当它已缓冲到可以开始播放的程度时) |
oncanplaythrough | 脚本 | 当文件可以从头到尾播放而无需暂停缓冲时运行的脚本 |
oncuechange | 脚本 | 当 <track> 元素中的提示发生变化时运行的脚本 |
ondurationchange | 脚本 | 当媒体的长度发生变化时运行的脚本 |
onemptied | 脚本 | 当发生意外情况并且文件突然不可用时运行的脚本(例如意外断开连接) |
onended | 脚本 | 当媒体播放结束时运行的脚本(对于“感谢收听”之类的消息很有用) |
onerror | 脚本 | 当加载文件时发生错误时运行的脚本 |
onloadeddata | 脚本 | 当加载媒体数据时运行的脚本 |
onloadedmetadata | 脚本 | 当元数据(如尺寸和持续时间)加载时运行的脚本 |
onloadstart | 脚本 | 当文件开始加载时运行的脚本,在此之前,实际上没有任何内容被加载 |
onpause | 脚本 | 当媒体被用户或以编程方式暂停时运行的脚本 |
onplay | 脚本 | 当媒体准备好开始播放时运行的脚本 |
onplaying | 脚本 | 当媒体实际开始播放时运行的脚本 |
onprogress | 脚本 | 当浏览器正在获取媒体数据时运行的脚本 |
onratechange | 脚本 | 每次播放速率更改时运行的脚本(例如,当用户切换到慢动作或快进模式时) |
onseeked | 脚本 | 当 seeking 属性设置为 false,表示寻路已结束时运行的脚本 |
onseeking | 脚本 | 当 seeking 属性设置为 true,表示寻路正在进行时运行的脚本 |
onstalled | 脚本 | 当浏览器由于任何原因无法获取媒体数据时运行的脚本 |
onsuspend | 脚本 | 当由于任何原因在完全加载之前停止获取媒体数据时运行的脚本 |
ontimeupdate | 脚本 | 当播放位置发生变化时运行的脚本(例如,当用户快进到媒体中的不同位置时) |
onvolumechange | 脚本 | 每次音量发生变化时运行的脚本(包括将音量设置为“静音”) |
onwaiting | 脚本 | 当媒体已暂停但预计将恢复时运行的脚本(例如,当媒体暂停以缓冲更多数据时) |
其他事件
属性 | 值 | 描述 |
---|---|---|
ontoggle | 脚本 | 当用户打开或关闭 <details> 元素时触发 |