事件參考

事件被觸發以通知程式碼可能影響程式碼執行的“有趣變化”。這些變化可能源於使用者互動,例如使用滑鼠或調整視窗大小,底層環境狀態的變化(例如低電量或來自作業系統的媒體事件),以及其他原因。

每個事件都由一個基於Event介面的物件表示,並且可能具有額外的自定義欄位和/或函式來提供有關發生事件的資訊。每個事件的文件都包含一個表格(靠近頂部),其中包含指向關聯事件介面的連結以及其他相關資訊。所有不同事件型別的完整列表在事件 > 基於事件的介面中給出。

本主題提供了一個索引,列出了您可能感興趣的主要型別的事件(動畫、剪貼簿、工作執行緒等),以及實現這些型別事件的主要類。

事件索引

事件型別 描述 文件
動畫

Web 動畫 API相關的事件。

用於響應動畫狀態的變化(例如,當動畫開始或結束時)。

DocumentWindowHTMLElement上觸發的動畫事件。
非同步資料獲取

與獲取資料相關的事件。

AbortSignalXMLHttpRequestFileReader上觸發的事件。
剪貼簿

剪貼簿 API相關的事件。

用於通知何時剪下、複製或貼上內容。

DocumentElementWindow上觸發的事件。
合成

與合成相關的事件;“間接”輸入文字(而不是使用正常的鍵盤按鍵)。

例如,透過語音到文字引擎輸入的文字,或使用特殊的按鍵組合來修改鍵盤按鍵以表示另一種語言中的新字元。

Element上觸發的事件。
CSS 過渡

CSS 過渡相關的事件。

在 CSS 過渡開始、停止、取消等時提供通知事件。

DocumentHTMLElementWindow上觸發的事件。
資料庫

與資料庫操作相關的事件:開啟、關閉、事務、錯誤等。

IDBDatabaseIDBOpenDBRequestIDBRequestIDBTransaction上觸發的事件。
DOM 變異

與文件物件模型 (DOM) 層次結構和節點的修改相關的事件。

警告:變異事件已棄用。應改用變異觀察器

拖放、滾輪

與使用HTML 拖放 API滾輪事件相關的事件。

拖放和滾輪事件派生自滑鼠事件。雖然它們在使用滑鼠滾輪或拖放時觸發,但也可以與其他合適的硬體一起使用。

Document上觸發的拖放事件

Element上觸發的滾輪事件

焦點

與元素獲得和失去焦點相關的事件。

ElementWindow上觸發的事件。
表單

與表單構建、重置和提交相關的事件。

HTMLFormElement上觸發的事件。
全屏

全屏 API相關的事件。

用於通知在全屏和視窗模式之間轉換時,以及在此轉換過程中發生的錯誤。

DocumentElement上觸發的事件。
遊戲手柄

遊戲手柄 API相關的事件。

Window上觸發的事件。
手勢

建議使用觸控事件來實現手勢。

DocumentElement上觸發的事件。

此外,還有一些非標準的手勢事件

歷史記錄

歷史記錄 API相關的事件。

Window上觸發的事件。
HTML 元素內容顯示管理

與更改顯示或文字元素的狀態相關的事件。

HTMLDetailsElementHTMLDialogElementHTMLSlotElement上觸發的事件。
輸入

與 HTML 輸入元素相關的事件,例如<input><select><textarea>

HTMLElementHTMLInputElement上觸發的事件。
鍵盤

與使用鍵盤相關的事件。

用於通知何時按下、鬆開或移動按鍵。

DocumentElement上觸發的事件。
載入/解除安裝文件

與載入和解除安裝文件相關的事件。

DocumentWindow上觸發的事件。

清單

與安裝漸進式 Web 應用清單相關的事件。

Window上觸發的事件。
媒體

與媒體使用相關的事件(包括媒體捕獲和流 APIWeb 音訊 API畫中畫 API等)。

ScriptProcessorNodeHTMLMediaElementAudioTrackListAudioScheduledSourceNodeMediaRecorderMediaStreamMediaStreamTrackVideoTrackListHTMLTrackElementOfflineAudioContextTextTrackTextTrackList元素/音訊元素/影片上觸發的事件。
訊息傳遞

與視窗從另一個瀏覽上下文接收訊息相關的事件。

Window上觸發的事件。
滑鼠

與使用計算機滑鼠相關的事件。

用於通知滑鼠何時單擊、雙擊、按下和鬆開事件、右鍵單擊、移入和移出元素、文字選擇等。

指標事件為滑鼠事件提供了一種與硬體無關的替代方案。拖放和滾輪事件派生自滑鼠事件。

Element上觸發的滑鼠事件
網路/連線

與獲得和失去網路連線相關的事件。

Window上觸發的事件。

NetworkInformation網路資訊 API)上觸發的事件。

支付

支付請求 API相關的事件。

PaymentRequestPaymentResponse上觸發的事件。

效能

與任何與效能相關的規範相關的事件,這些規範被分組到效能 API中。

Performance上觸發的事件。

指標

指標事件 API相關的事件。

提供來自指向裝置(包括滑鼠、觸控、筆/觸控筆)的與硬體無關的通知。

DocumentHTMLElement上觸發的事件。
列印

與列印相關的事件。

Window上觸發的事件。
Promise 拒絕

當任何 JavaScript Promise 被拒絕時,傳送到全域性指令碼上下文的事件。

Window上觸發的事件。
套接字

WebSockets API相關的事件。

Websocket上觸發的事件。
SVG

與 SVG 影像相關的事件。

SVGElementSVGAnimationElementSVGGraphicsElement上觸發的事件。

文字選擇

與選擇文字相關的選擇 API事件。

HTMLTextAreaElementHTMLInputElement上觸發的事件 (selectionchange)。

觸控

觸控事件 API相關的事件。

提供與互動式觸控式螢幕(即使用手指或觸控筆)相關的通知事件。與力度觸控 API無關。

DocumentElement上觸發的事件。
虛擬現實

WebXR 裝置 API相關的事件。

警告:WebVR API(以及相關的Window 事件)已棄用。

XRSystemXRSessionXRReferenceSpace上觸發的事件。
RTC(即時通訊)

WebRTC API相關的事件。

RTCDataChannelRTCDTMFSenderRTCIceTransportRTCPeerConnection上觸發的事件。
伺服器傳送事件

伺服器傳送事件 API相關的事件。

EventSource上觸發的事件。
語音

Web 語音 API相關的事件。

SpeechSynthesisUtterance上觸發的事件。
工作執行緒

Web 工作執行緒 API服務工作執行緒 API廣播通道 API通道訊息傳遞 API相關的事件。

用於響應新訊息和訊息傳送錯誤。服務工作執行緒還可以收到其他事件的通知,包括推送通知、使用者點選顯示的通知、推送訂閱已失效、從內容索引中刪除專案等。

ServiceWorkerGlobalScopeDedicatedWorkerGlobalScopeSharedWorkerGlobalScopeWorkerGlobalScopeWorkerBroadcastChannelMessagePort上觸發的事件。

規範

規範
HTML 標準
# events-2