HTML 事件属性 参考手册


全局事件属性

HTML 4增加了让事件在浏览器中触发操作的功能,例如当用户点击元素时启动JavaScript.

要了解有关编程事件的更多信息,请访问我们的 JavaScript教程

下面是可以添加到HTML元素以定义事件操作的全局事件属性.

= HTML5中的新事件属性.


窗口事件属性 (Window Event 属性)

为窗口对象触发的事件(适用于<body>标记):

属性 描述
onafterprint script 打印文档后要运行的脚本
onbeforeprint script 打印文档之前运行的脚本
onbeforeunload script 文档即将卸载时要运行的脚本
onerror script 发生错误时要运行的脚本
onhashchange script 当URL的锚点部分发生更改时要运行的脚本
onload script 当文档加载时运行脚本
onmessage script 当触发消息时运行脚本
onoffline script 当文档离线时运行脚本
ononline script 当文档上线时运行脚本
onpagehide script 该事件在用户离开当前网页跳转到另外一个页面时触发
onpageshow script 该事件在用户访问页面时触发
onpopstate script 该事件在窗口的浏览历史(history 对象)发生改变时触发
onresize script 当调整窗口大小时运行脚本
onstorage script 更新Web存储区域时要运行的脚本
onunload script 当用户离开文档时运行脚本


表单事件 (Form Events)

由HTML表单内的操作触发的事件(几乎适用于所有HTML元素,但最常用于表单元素):

属性 描述
onblur script 当元素失去焦点时运行脚本
onchange script 当元素改变时运行脚本
oncontextmenu script 触发上下文菜单时要运行的脚本
onfocus script 当窗口获得焦点时运行脚本
oninput script 当元素获得用户输入时运行脚本
oninvalid script 当元素无效时运行脚本
onreset script 当表单重置时运行脚本
onsearch script 当用户在搜索字段中写入内容时触发 (<input="search">)
onselect script 当选取元素时运行脚本
onsubmit script 当提交表单时运行脚本

键盘事件 (Keyboard Events)

属性 描述
onkeydown script 当按下按键时运行脚本
onkeypress script 当按下并松开按键时运行脚本
onkeyup script 当松开按键时运行脚本

鼠标事件 (Mouse Events)

属性 描述
onclick script 当单击鼠标时运行脚本
ondblclick script 当双击鼠标时运行脚本
onmousedown script 在元素上按下鼠标按钮时触发
onmousemove script 鼠标被移动
onmouseout script 鼠标从某元素移开
onmouseover script 鼠标移到某元素之上
onmouseup script 鼠标按键被松开
onmousewheel script 已废弃. 使用 onwheel 事件替代
onwheel script 当鼠标滚轮在元素上向上或向下滚动时要运行的脚本

拖动事件 (Drag Events)

属性 描述
ondrag script 拖动元素时要运行的脚本
ondragend script 在拖动操作结束时运行的脚本
ondragenter script 将元素拖动到有效放置目标时要运行的脚本
ondragleave script 当元素离开有效的放置目标时要运行的脚本
ondragover script 在有效放置目标上拖动元素时要运行的脚本
ondragstart script 要在拖动操作开始时运行的脚本
ondrop script 删除拖动元素时要运行的脚本
onscroll script 当文档被滚动时发生的事件

剪贴板事件 (Clipboard Events)

属性 描述
oncopy script 用户复制元素内容时触发
oncut script 用户剪切元素内容时触发
onpaste script 该事件在用户粘贴元素内容时触发

多媒体事件 (Media Events)

由视频,图像和音频等媒体触发的事件(适用于所有HTML元素,但在媒体元素中最常见,如<audio>,<embed>,<img>,<object>和<video>).

提示:有关详细信息,请参阅我们的 HTML 音频/视频(Audio/Video) DOM参考.

属性 描述
onabort script 事件在视频/音频(audio/video)终止加载时触发
oncanplay script 文件准备开始播放时要运行的脚本(当缓冲区已足够开始时)
oncanplaythrough script 当文件可以一直播放到最后而不暂停缓冲时运行的脚本
oncuechange script 当提示在 <track> 元素中更改时要运行的脚本
ondurationchange script 当媒体长度发生变化时要运行的脚本
onemptied script 发生错误并且文件突然不可用时运行的脚本(如意外断开连接)
onended script 媒体到达终点时要运行的脚本(对于"感谢收听"等消息的有用事件)
onerror script 加载文件时发生错误时要运行的脚本
onloadeddata script 事件在浏览器加载视频/音频(audio/video)当前帧时触发触发
onloadedmetadata script 事件在指定视频/音频(audio/video)的元数据加载后触发
onloadstart script 事件在浏览器开始寻找指定视频/音频(audio/video)触发
onpause script 事件在视频/音频(audio/video)暂停时触发
onplay script 媒体开始播放时要运行的脚本
onplaying script 媒体开始播放时要运行的脚本
onprogress script 事件在浏览器下载指定的视频/音频(audio/video)时触发
onratechange script 事件在视频/音频(audio/video)的播放速度发送改变时触发
onseeked script 事件在用户重新定位视频/音频(audio/video)的播放位置后触发
onseeking script 事件在用户开始重新定位视频/音频(audio/video)时触发
onstalled script 事件在浏览器获取媒体数据,但媒体数据不可用时触发
onsuspend script 获取媒体数据时要运行的脚本在出于任何原因完全加载之前停止
ontimeupdate script 播放位置发生变化时要运行的脚本(例如当用户快速转发到媒体中的其他位置时)
onvolumechange script 当媒介改变音量亦或当音量被设置为静音时运行脚本
onwaiting script 当媒体暂停但预计会恢复时(例如媒体暂停以缓冲更多数据时)要运行的脚本

其他事件

属性 描述
ontoggle script 当用户打开或关闭 <details>元素时触发