HTML 事件屬性
全域性事件屬性
HTML 能夠讓事件觸發瀏覽器中的操作,例如當用戶點選一個元素時啟動一個 JavaScript。
要了解更多關於程式設計事件的資訊,請訪問我們的 JavaScript 教程。
下面是可新增到 HTML 元素中以定義事件操作的全域性事件屬性。
視窗事件屬性
為 window 物件觸發的事件(應用於 <body> 標籤)
| Attribute | 值 | 描述 |
|---|---|---|
| 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 | 視窗歷史記錄更改時執行的指令碼 |
| onresize | script | 瀏覽器視窗大小調整時觸發 |
| onstorage | script | Web Storage 區域更新時執行的指令碼 |
| onunload | script | 頁面解除安裝(或瀏覽器視窗關閉)後觸發 |
表單事件
由 HTML 表單內的操作觸發的事件(適用於幾乎所有 HTML 元素,但最常用於表單元素)
| Attribute | 值 | 描述 |
|---|---|---|
| onblur | script | 元素失去焦點時觸發 |
| onchange | script | 元素值更改時觸發 |
| oncontextmenu | script | 觸發上下文選單時執行的指令碼 |
| onfocus | script | 元素獲得焦點時觸發 |
| oninput | script | 使用者向元素輸入內容時執行的指令碼 |
| oninvalid | script | 元素無效時執行的指令碼 |
| onreset | script | 表單中的重置按鈕被點選時觸發 |
| onsearch | script | 在搜尋欄位(對於 <input="search">)中輸入內容時觸發 |
| onselect | script | 元素中選擇了一些文字後觸發 |
| onsubmit | script | 表單提交時觸發 |
鍵盤事件
| Attribute | 值 | 描述 |
|---|---|---|
| onkeydown | script | 使用者按鍵時觸發 |
| onkeypress | script | 使用者按下某個鍵時觸發 |
| onkeyup | script | 使用者釋放按鍵時觸發 |
滑鼠事件
| Attribute | 值 | 描述 |
|---|---|---|
| onclick | script | 在元素上滑鼠單擊時觸發 |
| ondblclick | script | 在元素上滑鼠雙擊時觸發 |
| onmousedown | script | 在元素上按下滑鼠按鈕時觸發 |
| onmousemove | script | 當滑鼠指標在元素上方移動時觸發 |
| onmouseout | script | 滑鼠指標移出元素範圍時觸發 |
| onmouseover | script | 滑鼠指標移到元素上方時觸發 |
| onmouseup | script | 在元素上釋放滑鼠按鈕時觸發 |
| onmousewheel | script | 已棄用。 請使用 onwheel 屬性代替 |
| onwheel | script | 滑鼠滾輪在元素上向上或向下滾動時觸發 |
拖放事件
| Attribute | 值 | 描述 |
|---|---|---|
| ondrag | script | 拖動元素時執行的指令碼 |
| ondragend | script | 拖動操作結束時執行的指令碼 |
| ondragenter | script | 將拖動的元素拖到有效放置目標時執行的指令碼 |
| ondragleave | script | 元素離開有效放置目標時執行的指令碼 |
| ondragover | script | 元素正在拖動到有效放置目標時執行的指令碼 |
| ondragstart | script | 拖動操作開始時執行的指令碼 |
| ondrop | script | 拖動元素被放置時執行的指令碼 |
| onscroll | script | 滾動元素捲軸時執行的指令碼 |
剪貼簿事件
| Attribute | 值 | 描述 |
|---|---|---|
| oncopy | script | 使用者複製元素內容時觸發 |
| oncut | script | 使用者剪下元素內容時觸發 |
| onpaste | script | 使用者在元素中貼上內容時觸發 |
媒體事件
由影片、影像和音訊等媒體觸發的事件(適用於所有 HTML 元素,但在媒體元素(如 <audio>、<embed>、<img>、<object> 和 <video>)中最為常見)。
提示: 有關更多資訊,請參閱我們的 HTML 音訊和影片 DOM 參考。
| Attribute | 值 | 描述 |
|---|---|---|
| onabort | script | 中止時執行的指令碼 |
| oncanplay | script | 檔案準備好開始播放時執行的指令碼(當它已緩衝足夠開始播放時) |
| oncanplaythrough | script | 檔案可以一直播放到結束而無需暫停緩衝時執行的指令碼 |
| oncuechange | script | <track> 元素中的提示發生更改時執行的指令碼 |
| ondurationchange | script | 媒體長度更改時執行的指令碼 |
| onemptied | script | 檔案突然變得不可用時(例如意外斷開連線)發生的錯誤時執行的指令碼 |
| onended | script | 媒體到達結尾時執行的指令碼(例如“感謝收聽”等訊息的有用事件) |
| onerror | script | 載入檔案時發生錯誤時執行的指令碼 |
| onloadeddata | script | 載入媒體資料時執行的指令碼 |
| onloadedmetadata | script | 載入元資料(如尺寸和時長)時執行的指令碼 |
| onloadstart | script | 在實際載入任何內容之前,檔案開始載入時執行的指令碼 |
| onpause | script | 使用者或程式暫停媒體時執行的指令碼 |
| onplay | script | 媒體準備開始播放時執行的指令碼 |
| onplaying | script | 媒體實際開始播放時執行的指令碼 |
| onprogress | script | 瀏覽器在獲取媒體資料過程中執行時執行的指令碼 |
| onratechange | script | 播放速率改變時(例如當用戶切換到慢動作或快進模式時)每次執行的指令碼 |
| onseeked | script | 設定 seeking 屬性為 false(表示尋找已結束)時執行的指令碼 |
| onseeking | script | 設定 seeking 屬性為 true(表示尋找正在進行)時執行的指令碼 |
| onstalled | script | 無論何種原因,瀏覽器無法獲取媒體資料時執行的指令碼 |
| onsuspend | script | 無論何種原因,在完全載入媒體資料之前停止獲取媒體資料時執行的指令碼 |
| ontimeupdate | script | 播放位置發生改變時(例如當用戶快進到媒體的不同點時)每次執行的指令碼 |
| onvolumechange | script | 每次音量改變時(包括將音量設定為“靜音”)執行的指令碼 |
| onwaiting | script | 媒體暫停但預期會恢復時(例如當媒體暫停以緩衝更多資料時)執行的指令碼 |
雜項事件
| Attribute | 值 | 描述 |
|---|---|---|
| ontoggle | script | 使用者開啟或關閉 <details> 元素時觸發 |