事件是 JavaScript 與使用者互動的橋樑。以下依功能分類整理常用事件,並標示其觸發時機。表格中的瀏覽器支援欄位是歷史資訊,現代瀏覽器已全面支援主流事件,僅供理解演進脈絡參考。
| 事件 | 觸發時機 |
|---|---|
| onClick | 滑鼠點擊,最常用於某物件控制範圍內的點擊 |
| onDblClick | 滑鼠雙擊 |
| onMouseDown | 滑鼠上的按鈕被按下 |
| onMouseUp | 滑鼠按下的按鈕被放開時 |
| onMouseOver | 滑鼠移動到某物件範圍上方時 |
| onMouseMove | 滑鼠移動時 |
| onMouseOut | 滑鼠離開某物件範圍時 |
| onKeyPress | 鍵盤某鍵被按下並放開時(頁面內必須有取得焦點的物件) |
| onKeyDown | 鍵盤某鍵被按下時(同上) |
| onKeyUp | 鍵盤某鍵被放開時(同上) |
| 事件 | 觸發時機 |
|---|---|
| onAbort | 圖片在下載時被使用者中斷 |
| onBeforeUnload | 目前頁面的內容將要被改變時 |
| onError | 頁面因某種原因出現錯誤,如腳本錯誤或外部資料引用失敗 |
| onLoad | 頁面內容完成傳送到瀏覽器時,包含外部檔案載入完成 |
| onMove | 瀏覽器視窗被移動時 |
| onResize | 瀏覽器視窗大小改變時 |
| onScroll | 捲動條位置變化時 |
| onStop | 瀏覽器停止鈕被按下,或正在下載的檔案被中斷 |
| onUnload | 目前頁面將被離開時 |
| 事件 | 觸發時機 |
|---|---|
| onBlur | 目前元素失去焦點時(滑鼠與鍵盤的觸發均可) |
| onChange | 元素失去焦點且內容已改變時(滑鼠與鍵盤均可) |
| onFocus | 某個元素取得焦點時 |
| onReset | 表單中 RESET 屬性被觸發時 |
| onSubmit | 一個表單被提交時 |
這裡有個常見誤會:onChange 對文字框而言,不是每次打字都觸發,而是要等到失去焦點才檢查。想做即時驗證應該監聽 oninput 或 onkeyup。
| 事件 | 觸發時機 |
|---|---|
| onBounce | Marquee 內的內容移動至可視範圍之外時 |
| onFinish | Marquee 元素完成需要顯示的內容後 |
| onStart | Marquee 元素開始顯示內容時 |
| 事件 | 觸發時機 |
|---|---|
| onBeforeCopy | 被選擇的內容將要複製到系統剪貼簿之前 |
| onBeforeCut | 頁面內容將被剪下並移到系統剪貼簿時 |
| onBeforeEditFocus | 目前元素將要進入編輯狀態 |
| onBeforePaste | 內容將要從系統剪貼簿貼到頁面中時 |
| onBeforeUpdate | 使用者貼上剪貼簿內容時通知目標物件 |
| onContextMenu | 按下滑鼠右鍵出現選單,或以鍵盤觸發頁面選單時 |
| onCopy | 被選擇的內容複製完成後 |
| onCut | 被選擇的內容被剪下時 |
| onDrag | 某個物件被拖動時(活動事件) |
| onDragDrop | 一個外部物件被滑鼠拖進目前視窗或框架 |
| onDragEnd | 滑鼠拖動結束、按鈕被放開時 |
| onDragEnter | 被拖動的物件進入其容器範圍內時 |
| onDragLeave | 被拖動的物件離開其容器範圍時 |
| onDragOver | 被拖動的物件在另一物件容器範圍內移動時(活動事件) |
| onDragStart | 某個物件將要被拖動時 |
| onDrop | 拖動過程中放開滑鼠鍵時 |
| onLoseCapture | 元素失去滑鼠移動所形成的選擇焦點時 |
| onPaste | 內容被貼上時 |
| onSelect | 文字內容被選擇時 |
| onSelectStart | 文字內容選擇將要開始發生時 |
想禁止右鍵選單,在 body 上寫 oncontextmenu="return false" 即可。不過要提醒:封鎖右鍵選單並不能保護你的內容,那只會讓正常使用者感到不便,不构成任何防護。
| 事件 | 觸發時機 |
|---|---|
| onAfterUpdate | 資料完成由資料來源到物件的傳送時 |
| onCellChange | 資料來源發生變化時 |
| onDataAvailable | 資料接收完成時 |
| onDatasetChanged | 資料來源發生變化時 |
| onDatasetComplete | 來自資料來源的全部有效資料讀取完畢時 |
| onErrorUpdate | onBeforeUpdate 取消了資料傳送時,代替 onAfterUpdate |
| onRowEnter | 資料來源發生變化且有新的有效資料時 |
| onRowExit | 資料來源的資料將要發生變化時 |
| onRowsDelete | 目前的資料記錄將被刪除時 |
| onRowsInserted | 資料來源將要插入新記錄時 |
| 事件 | 觸發時機 |
|---|---|
| onAfterPrint | 文件被列印之後 |
| onBeforePrint | 文件即將列印時 |
| onFilterChange | 某個物件的濾鏡效果變化時 |
| onHelp | 按下 F1 或瀏覽器說明選單時 |
| onPropertyChange | 物件的屬性之一變化時 |
| onReadyStateChange | 物件的初始化屬性值變化時(Ajax 的核心事件) |
把事件直接寫在 HTML 屬性裡(<button onclick="...">)雖然方便,但會讓結構與行為糾纏在一起。建議改用 addEventListener:
document.getElementById('myBtn').addEventListener('click', function (e) {
e.preventDefault();
// 處理邏輯
}, false);
它的三個優勢是:同一個事件可以綁定多個監聽器而不互相覆蓋;可以透過 capture 參數控制捕獲或冒泡階段;可以用 removeEventListener 精確移除。對比之下,element.onclick = fn 這種寫法會直接覆蓋掉先前的設定。
另外,onReadyStateChange 是舊式 Ajax 的核心,今天用 fetch 的 Promise 語法會乾淨許多:
fetch('/api/data')
.then(function (r) { return r.json(); })
.then(function (data) { console.log(data); });
而 Marquee 相關事件、資料綁定系列事件都屬於 IE 獨有的歷史產物,現代專案不需要理會。若要有捲動效果,用 CSS 動畫或 requestAnimationFrame 才是正確途徑。