jQuery 的事件 API 數量不少,依功能分類會好記很多。
| 方法 | 說明 |
|---|---|
bind() | 為符合的元素掛上一個或多個事件處理器(舊寫法) |
live() | 為當前與未來的元素掛上處理器(1.9 已移除) |
delegate() | 為符合元素的現在或未來子元素掛上處理器 |
one() | 掛上處理器,每個元素只觸發一次即自動移除 |
toggle() | 掛上多個處理器,輪流對應連續的 click |
unbind() | 移除已掛上的處理器 |
die() | 移除以 live() 掛上的處理器 |
undelegate() | 移除以 delegate() 掛上的處理器 |
click()、dblclick()、mousedown()、mouseup()、mousemove()、mouseover()、mouseout()、mouseenter()、mouseleave()
這些方法都有兩種用法:不帶參數時「觸發」事件,帶函式參數時「綁定」處理器。
keydown()、keypress()、keyup()
focus()、blur()、change()、select()、submit()
ready()(DOM 就緒)、load()(資源載入)、unload()、error()、resize()、scroll()
| 項目 | 說明 |
|---|---|
trigger() | 觸發符合集合中所有元素的指定事件 |
triggerHandler() | 只觸發第一個符合元素的指定事件,且不執行瀏覽器預設行為 |
event.isDefaultPrevented() | 是否已呼叫 preventDefault() |
event.preventDefault() | 阻止事件的預設動作 |
event.target | 觸發該事件的 DOM 元素 |
event.type | 事件類型名稱 |
event.which | 按下了哪個鍵或滑鼠按鍵 |
event.pageX / pageY | 滑鼠相對於文件的座標 |
event.result | 最後一個處理器的回傳值 |
event.timeStamp | 事件發生時間的毫秒數(自 1970-01-01 起) |
上表中的 bind()、live()、delegate() 都已被 on() 取代(live() 自 1.9 起移除,其餘標示為不建議)。新專案請統一使用:
$(".item").on("click", handler); // 直接綁定
$("#list").on("click", ".item", handler); // 事件委派
$(document).off("click", handler); // 移除