事件參考
事件被觸發以通知程式碼可能影響程式碼執行的“有趣變化”。這些變化可能源於使用者互動,例如使用滑鼠或調整視窗大小,底層環境狀態的變化(例如低電量或來自作業系統的媒體事件),以及其他原因。
每個事件都由一個基於Event介面的物件表示,並且可能具有額外的自定義欄位和/或函式來提供有關發生事件的資訊。每個事件的文件都包含一個表格(靠近頂部),其中包含指向關聯事件介面的連結以及其他相關資訊。所有不同事件型別的完整列表在事件 > 基於事件的介面中給出。
本主題提供了一個索引,列出了您可能感興趣的主要型別的事件(動畫、剪貼簿、工作執行緒等),以及實現這些型別事件的主要類。
事件索引
| 事件型別 | 描述 | 文件 |
|---|---|---|
| 動畫 |
與Web 動畫 API相關的事件。 用於響應動畫狀態的變化(例如,當動畫開始或結束時)。 |
在Document、Window、HTMLElement上觸發的動畫事件。 |
| 非同步資料獲取 |
與獲取資料相關的事件。 |
在AbortSignal、XMLHttpRequest、FileReader上觸發的事件。 |
| 剪貼簿 |
與剪貼簿 API相關的事件。 用於通知何時剪下、複製或貼上內容。 |
在Document、Element、Window上觸發的事件。 |
| 合成 |
與合成相關的事件;“間接”輸入文字(而不是使用正常的鍵盤按鍵)。 例如,透過語音到文字引擎輸入的文字,或使用特殊的按鍵組合來修改鍵盤按鍵以表示另一種語言中的新字元。 |
在Element上觸發的事件。 |
| CSS 過渡 |
與CSS 過渡相關的事件。 在 CSS 過渡開始、停止、取消等時提供通知事件。 |
在Document、HTMLElement、Window上觸發的事件。 |
| 資料庫 |
與資料庫操作相關的事件:開啟、關閉、事務、錯誤等。 |
在IDBDatabase、IDBOpenDBRequest、IDBRequest、IDBTransaction上觸發的事件。 |
| DOM 變異 |
與文件物件模型 (DOM) 層次結構和節點的修改相關的事件。 |
|
| 拖放、滾輪 |
與使用HTML 拖放 API和滾輪事件相關的事件。 拖放和滾輪事件派生自滑鼠事件。雖然它們在使用滑鼠滾輪或拖放時觸發,但也可以與其他合適的硬體一起使用。 |
在 在 |
| 焦點 |
與元素獲得和失去焦點相關的事件。 |
在Element、Window上觸發的事件。 |
| 表單 |
與表單構建、重置和提交相關的事件。 |
在HTMLFormElement上觸發的事件。 |
| 全屏 |
與全屏 API相關的事件。 用於通知在全屏和視窗模式之間轉換時,以及在此轉換過程中發生的錯誤。 |
在Document、Element上觸發的事件。 |
| 遊戲手柄 |
與遊戲手柄 API相關的事件。 |
在Window上觸發的事件。 |
| 手勢 |
建議使用觸控事件來實現手勢。 |
此外,還有一些非標準的手勢事件
|
| 歷史記錄 |
與歷史記錄 API相關的事件。 |
在Window上觸發的事件。 |
| HTML 元素內容顯示管理 |
與更改顯示或文字元素的狀態相關的事件。 |
在HTMLDetailsElement、HTMLDialogElement、HTMLSlotElement上觸發的事件。 |
| 輸入 |
與 HTML 輸入元素相關的事件,例如 |
在HTMLElement、HTMLInputElement上觸發的事件。 |
| 鍵盤 |
與使用鍵盤相關的事件。 用於通知何時按下、鬆開或移動按鍵。 |
在Document、Element上觸發的事件。 |
| 載入/解除安裝文件 |
與載入和解除安裝文件相關的事件。 |
|
| 清單 |
與安裝漸進式 Web 應用清單相關的事件。 |
在Window上觸發的事件。 |
| 媒體 |
與媒體使用相關的事件(包括媒體捕獲和流 API、Web 音訊 API、畫中畫 API等)。 |
在ScriptProcessorNode、HTMLMediaElement、AudioTrackList、AudioScheduledSourceNode、MediaRecorder、MediaStream、MediaStreamTrack、VideoTrackList、HTMLTrackElement、OfflineAudioContext、TextTrack、TextTrackList、元素/音訊、元素/影片上觸發的事件。 |
| 訊息傳遞 |
與視窗從另一個瀏覽上下文接收訊息相關的事件。 |
在Window上觸發的事件。 |
| 滑鼠 |
與使用計算機滑鼠相關的事件。 用於通知滑鼠何時單擊、雙擊、按下和鬆開事件、右鍵單擊、移入和移出元素、文字選擇等。 指標事件為滑鼠事件提供了一種與硬體無關的替代方案。拖放和滾輪事件派生自滑鼠事件。 |
在Element上觸發的滑鼠事件 |
| 網路/連線 |
與獲得和失去網路連線相關的事件。 |
在 在 |
| 支付 |
與支付請求 API相關的事件。 |
在 |
| 效能 |
與任何與效能相關的規範相關的事件,這些規範被分組到效能 API中。 |
在 |
| 指標 |
與指標事件 API相關的事件。 提供來自指向裝置(包括滑鼠、觸控、筆/觸控筆)的與硬體無關的通知。 |
在Document、HTMLElement上觸發的事件。 |
| 列印 |
與列印相關的事件。 |
在Window上觸發的事件。 |
| Promise 拒絕 |
當任何 JavaScript Promise 被拒絕時,傳送到全域性指令碼上下文的事件。 |
在Window上觸發的事件。 |
| 套接字 |
與WebSockets API相關的事件。 |
在Websocket上觸發的事件。 |
| SVG |
與 SVG 影像相關的事件。 |
|
| 文字選擇 |
與選擇文字相關的選擇 API事件。 |
在 |
| 觸控 |
與觸控事件 API相關的事件。 提供與互動式觸控式螢幕(即使用手指或觸控筆)相關的通知事件。與力度觸控 API無關。 |
在Document、Element上觸發的事件。 |
| 虛擬現實 |
與WebXR 裝置 API相關的事件。 |
在XRSystem、XRSession、XRReferenceSpace上觸發的事件。 |
| RTC(即時通訊) |
與WebRTC API相關的事件。 |
在RTCDataChannel、RTCDTMFSender、RTCIceTransport、RTCPeerConnection上觸發的事件。 |
| 伺服器傳送事件 |
與伺服器傳送事件 API相關的事件。 |
在EventSource上觸發的事件。 |
| 語音 |
與Web 語音 API相關的事件。 |
在SpeechSynthesisUtterance上觸發的事件。 |
| 工作執行緒 |
與Web 工作執行緒 API、服務工作執行緒 API、廣播通道 API和通道訊息傳遞 API相關的事件。 用於響應新訊息和訊息傳送錯誤。服務工作執行緒還可以收到其他事件的通知,包括推送通知、使用者點選顯示的通知、推送訂閱已失效、從內容索引中刪除專案等。 |
在ServiceWorkerGlobalScope、DedicatedWorkerGlobalScope、SharedWorkerGlobalScope、WorkerGlobalScope、Worker、BroadcastChannel、MessagePort上觸發的事件。 |
規範
| 規範 |
|---|
| HTML 標準 # events-2 |