事件参考
事件的触发用于通知“对变化感兴趣”的代码以影响代码的执行。这些事件可能来自用户的交互(例如:使用鼠标或调整窗口大小)、底层环境状态的改变(例如:电池电量不足或操作系统的媒体事件)和其他的情况。
每个事件都使用继承自 Event
接口的对象来表示,可以包括额外的自定义成员属性及函数,以获取事件发生时相关的更多信息。本文为每个事件都提供了一个表格(靠近顶部的区域),其中包含了指向相关事件接口的链接和其他相关的信息。事件 > 基于 Event
的接口中完整地列出了不同的事件类型。
本文提供了你可能感兴趣的主要事件类型(动画、剪切板、worker,等等)的索引,以及实现这些事件的主要的类。最后是所有提供了文档的事件列表。
备注: 此页面列出了你会在 web 上遇到的绝大多数常见事件。如果你正在查找一个这里没有列出的事件,请尝试在 MDN 上搜索它的名字、主题或关联的规范。
事件索引
事件类型 | 描述 | 文档 |
---|---|---|
动画 |
与 Web Animation API 相关的事件。 用于响应动画状态的改变(例如:动画的开始或结束)。 |
在
Document 、Window 、HTMLElement 上触发的事件。
|
异步数据获取 |
与数据获取相关的事件。 |
在
AbortSignal 、XMLHttpRequest 、FileReader 上触发的事件。
|
剪切板 |
与 Clipboard API 相关的事件。 用于在内容被剪切、复制或粘贴时发出通知。 |
在
Document 、Window 、HTMLElement 上触发的事件。
|
文本输入(Composition) |
与文本输入相关的事件;“间接”输入文本(而不是直接使用常规的键盘输入)。 例如,使用语音转文字的引擎,或使用特殊的组合键以将键入的内容表示成另一种语言中的字符。 |
在
Element 上触发的事件。
|
CSS 变换 |
与 CSS 变换相关的事件。 当 CSS 变换开始、停止或取消等事件发生时发出通知。 |
在
Document 、Window 、HTMLElement 上触发的事件。
|
数据库 |
与数据库操作相关的事件:打开、关闭、事务、错误,等等。 |
在
IDBDatabase 、IDBOpenDBRequest 、IDBRequest 、IDBTransaction 上触发的事件。
|
DOM 突变 |
与文档对象模型(DOM)层次结构和节点的修改相关的事件。 |
警告: 突变事件已被废弃。请使用 MutationObserver 代替。 |
拖放、滚轮 |
与使用 HTML 拖放 API 和滚轮事件相关的事件。 拖动和滚轮事件派生自鼠标事件。虽然它们在使用鼠标滚轮和拖放时触发,但它们也可以和其他合适的硬件一起使用。 |
拖放事件在
|
焦点 |
与元素获得和失去焦点相关的事件。 |
在
Element 、Window 上触发的事件。
|
表单 |
与创建、重置和提交表单相关的事件。 |
在
HTMLFormElement 上触发。
|
全屏 |
与 Fullscreen API 相关的事件。 用于在全屏和窗口模式切换或切换期间发生错误时发送通知。 |
在
Document 、Element 上触发的事件。
|
游戏手柄(Gamepad) |
与 Gamepad API 相关的事件。 |
在
Window 上触发的事件。
|
手势 |
建议使用 Touch 事件来实现手势。 |
此外还有一些非标准的手势事件:
|
History |
与 History API 相关的事件。 |
在
Window 上触发的事件。
|
HTML 元素内容显示管理 |
与显示或文本元素状态的改变相关的事件。 |
在
HTMLDetailsElement 、HTMLDialogElement 、HTMLSlotElement 上触发的事件。
|
输入 |
与 HTML input 元素(如: |
在
HTMLElement 、HTMLInputElement 上触发的事件。
|
键盘 |
与使用键盘相关的事件。 用于在按键向上、向下或仅仅只是按下时发出通知。 |
在
Document 、Element 上触发的事件。
|
加载/卸载文档 |
在加载或卸载文档时触发的事件。 |
|
清单 |
与安装渐进式 web 应用清单相关的事件。 |
在
Window 上触发的事件
|
媒体 |
与媒体使用(包括媒体捕捉与媒体流 API、Web Audio API、画中画 API,等等)相关的事件。 |
在
ScriptProcessorNode 、HTMLMediaElement 、AudioTrackList 、AudioScheduledSourceNode 、MediaRecorder 、MediaStream 、MediaStreamTrack 、VideoTrackList 、HTMLTrackElement 、OfflineAudioContext 、TextTrack 、TextTrackList 、Element/audio,
Element/video 上触发的事件。
|
消息传递 |
与窗口从另一个浏览上下文接受消息相关的事件。 |
在
Window 上触发的事件。
|
鼠标 |
与计算机鼠标相关的事件。 用于在鼠标单机、双击、释放、按下、右击、移入移除元素/文本、选择等动作时发出通知。 指针事件为鼠标事件提供了与硬件无关的代替方案。拖放和滚轮事件派生自鼠标事件。 |
在
Element 上触发的事件。
|
网络连接 |
与获得和失去网络连接相关的事件。 |
在
在
|
支付 |
与支付请求 API 相关的事件。 |
在
|
性能 |
与 High Resolution Time API、Navigation Timing API、User Timing API 和 Resource Timing API 相关的事件。 |
在
|
指针 |
与指针事件 API 相关的事件。 提供来自指针设备(包括鼠标、触控、笔/触控笔)的与硬件无关的通知。 |
在
Document 、HTMLElement 上触发的事件。
|
打印 |
与打印相关的事件。 |
在
Window 上触发的事件。
|
Promise rejection |
在任意 JavaScript promise 被拒绝时,发送到全局脚本上下文的事件。 |
在
Window 上触发的事件。
|
网络套接字 |
与 WebSockets API 相关的事件。 |
在
Websocket 上触发的事件。
|
SVG |
与 SVG 图像相关的事件。 |
在
|
文本选择 |
与选择文本相关的 Selection API 事件。 |
事件( |
触控 |
与 Touch Events API 相关的事件。 在与触控屏交互(例如:用手指或触控笔)时发出通知。与 Force Touch API 无关。 |
在
Document 、Element 上触发的事件。
|
虚拟现实 |
与 WebXR Device API 相关的事件。 |
在
XRSystem 、XRSession 、XRReferenceSpace 上触发的事件。
|
RTC(实时通信) |
与 WebRTC API 相关的事件。 |
在
RTCDataChannel 、RTCDTMFSender 、RTCIceTransport 、RTCPeerConnection 上触发的事件。
|
Server-sent 事件 |
与 server sent events API 相关的事件。 |
在
EventSource 上触发的事件。
|
语音合成 |
与 Web Speech API 相关的事件。 |
在
SpeechSynthesisUtterance 上触发的事件。
|
Worker |
与 Web Workers API、Service Worker API、Broadcast Channel API 和 Channel Messaging API 相关的事件。 用于相应新消息和消息发送的错误。Service worker 还可以收到其他事件的通知,包括推送通知、用户单击显示的通知 push 订阅失效、从内容索引中删除条目,等等。 |
在
ServiceWorkerGlobalScope 、DedicatedWorkerGlobalScope 、SharedWorkerGlobalScope 、WorkerGlobalScope 、Worker 、WorkerGlobalScope 、BroadcastChannel 、MessagePort 上触发的事件。
|
事件列表
本节列出了在 MDN 上有自己的参考页面的事件。如果下面没有列出你感兴趣的某个事件,请尝试搜索它的名字、主题或关联的规范。
AbortSignal
AudioScheduledSourceNode
AudioTrackList
BroadcastChannel
DedicatedWorkerGlobalScope
Document
- animationcancel 事件
- animationend 事件
- animationiteration 事件
- animationstart 事件
- copy 事件
- cut 事件
- DOMContentLoaded 事件
- dragend 事件
- dragenter 事件
- dragleave 事件
- dragover 事件
- dragstart 事件
- drag 事件
- drop 事件
- fullscreenchange 事件
- fullscreenerror 事件
- gotpointercapture 事件
- keydown 事件
- keypress 事件
- keyup 事件
- lostpointercapture 事件
- paste 事件
- pointercancel 事件
- pointerdown 事件
- pointerenter 事件
- pointerleave 事件
- pointerlockchange 事件
- pointerlockerror 事件
- pointermove 事件
- pointerout 事件
- pointerover 事件
- pointerup 事件
- readystatechange 事件
- scroll 事件
- selectionchange 事件
- selectstart 事件
- touchcancel 事件
- touchend 事件
- touchmove 事件
- touchstart 事件
- transitioncancel 事件
- transitionend 事件
- transitionrun 事件
- transitionstart 事件
- visibilitychange 事件
- wheel 事件
Element
- afterscriptexecute 事件
- auxclick 事件
- beforescriptexecute 事件
- blur 事件
- click 事件
- compositionend 事件
- compositionstart 事件
- compositionupdate 事件
- contextmenu 事件
- copy 事件
- cut 事件
- dblclick 事件
- DOMActivate 事件
- DOMMouseScroll 事件
- error 事件
- focusin 事件
- focusout 事件
- focus 事件
- fullscreenchange 事件
- fullscreenerror 事件
- gesturechange 事件
- gestureend 事件
- gesturestart 事件
- keydown 事件
- keypress 事件
- keyup 事件
- mousedown 事件
- mouseenter 事件
- mouseleave 事件
- mousemove 事件
- mouseout 事件
- mouseover 事件
- mouseup 事件
- mousewheel 事件
- msContentZoom 事件
- MSGestureChange 事件
- MSGestureEnd 事件
- MSGestureHold 事件
- MSGestureStart 事件
- MSGestureTap 事件
- MSInertiaStart 事件
- MSManipulationStateChanged 事件
- paste 事件
- scroll 事件
- select 事件
- touchcancel 事件
- touchend 事件
- touchmove 事件
- touchstart 事件
- webkitmouseforcechanged 事件
- webkitmouseforcedown 事件
- webkitmouseforceup 事件
- webkitmouseforcewillbegin 事件
- wheel 事件
EventSource
FileReader
HTMLCanvasElement
HTMLDetailsElement
HTMLDialogElement
HTMLElement
- animationcancel 事件
- animationend 事件
- animationiteration 事件
- animationstart 事件
- beforeinput 事件
- change 事件
- gotpointercapture 事件
- input 事件
- lostpointercapture 事件
- pointercancel 事件
- pointerdown 事件
- pointerenter 事件
- pointerleave 事件
- pointermove 事件
- pointerout 事件
- pointerover 事件
- pointerup 事件
- transitioncancel 事件
- transitionend 事件
- transitionrun 事件
- transitionstart 事件
HTMLFormElement
HTMLInputElement
HTMLMediaElement
HTMLSlotElement
HTMLTrackElement
HTMLVideoElement
IDBDatabase
IDBOpenDBRequest
IDBRequest
IDBTransaction
MediaDevices
MediaRecorder
MediaStream
MediaStreamTrack
MessagePort
OfflineAudioContext
PaymentRequest
PaymentResponse
Performance
PictureInPictureWindow
RTCDataChannel
RTCDtlsTransport
RTCDTMFSender
RTCIceTransport
RTCPeerConnection
ScriptProcessorNode
ServiceWorkerContainer
ServiceWorkerGlobalScope
SharedWorkerGlobalScope
SpeechRecognition
SpeechSynthesis
SpeechSynthesisUtterance
SVGAnimationElement
SVGElement
SVGGraphicsElement
TextTrack
TextTrackList
VideoTrackList
VisualViewport
WebSocket
Window
- afterprint 事件
- animationcancel 事件
- animationend 事件
- animationiteration 事件
- animationstart 事件
- appinstalled 事件
- beforeprint 事件
- beforeunload 事件
- blur 事件
- copy 事件
- cut 事件
- devicemotion 事件
- deviceorientation 事件
- error 事件
- focus 事件
- gamepadconnected 事件
- gamepaddisconnected 事件
- hashchange 事件
- languagechange 事件
- load 事件
- messageerror 事件
- message 事件
- offline 事件
- online 事件
- orientationchange 事件
- pagehide 事件
- pageshow 事件
- paste 事件
- popstate 事件
- rejectionhandled 事件
- resize 事件
- storage 事件
- transitioncancel 事件
- transitionend 事件
- transitionrun 事件
- transitionstart 事件
- unhandledrejection 事件
- unload 事件
- vrdisplayactivate 事件
- vrdisplayblur 事件
- vrdisplayconnect 事件
- vrdisplaydeactivate 事件
- vrdisplaydisconnect 事件
- vrdisplayfocus 事件
- vrdisplaypointerrestricted 事件
- vrdisplaypointerunrestricted 事件
- vrdisplaypresentchange 事件
Worker
WorkerGlobalScope
XMLHttpRequest
XRReferenceSpace
XRSession
XRSystem
规范
Specification |
---|
HTML Standard # events-2 |