事件處理函式收到的那個參數(慣例命名為 event 或 e),承載了這次事件的所有資訊:來源元素、按了哪個鍵、游標在哪裡。以下整理最常用到的幾個屬性與操作方式。
<script>
$(function () {
$("a").click(function (event) {
alert(event.type); // "click"
// return false; // 也可阻止連結跳轉
event.preventDefault(); // 更明確的寫法
});
});
</script>
同一個函式若被綁至多種事件,type 就能用來分辨目前是哪一種。
<a href='https://google.com'>click me .</a>
<script>
$(function () {
$("a[href=https://google.com]").click(function (event) {
alert(event.target.href); // 取得該 a 元素的 href 屬性
return false; // 阻止跳轉
});
});
</script>
event.target 是實際觸發事件的元素,而 this 是綁定事件的元素。兩者在事件委派時會不同,這是最容易搞混的一組:
$('#list').on('click', 'li', function (e) {
console.log(this === e.target); // 點 li 裡的 span 時,結果是 false
});
<script>
$(function () {
$("a").click(function (e) {
alert("Current mouse position: " + e.pageX + ", " + e.pageY);
return false;
});
});
</script>
jQuery 已幫你正規化座標,pageX/pageY 在各瀏覽器行為一致,這正是用 jQuery 而非原生 API 的實惠之一。若需要相對視窗的座標,用 clientX/clientY。
<script>
$(function () {
$("a").mousedown(function (e) {
alert(e.which); // 1 = 左鍵, 2 = 中鍵, 3 = 右鍵
return false;
});
});
</script>
jQuery 同樣把 which 做了跨瀏覽器正規化——原生 API 中滑鼠鍵用 button、鍵盤鍵用 which,jQuery 統一用 which 並處理了舊 IE 從 1 起算、標準從 0 起算的差異。
| Keycode | 按鍵 |
|---|---|
| 8 | Backspace |
| 9 | Tab |
| 13 | Enter |
| 16 | Shift |
| 17 | Ctrl |
| 18 | Alt |
| 20 | Caps Lock |
| 27 | Esc |
| 32 | 空白鍵 |
| 37–40 | 方向鍵 Left / Up / Right / Down |
| 46 | Delete |
| 48–57 | 數字鍵 0–9 |
| 65–90 | 字母 A–Z |
| 112–123 | F1–F12 |
其中最常用到的莫過於 13(Enter)、32(空白)、27(Esc)、16(Shift)、17(Ctrl)、18(Alt)。
臨時查值可以直接這樣做:
<script>
$(function () {
$("input").keyup(function (e) {
alert(e.which);
});
});
</script>
這份對照表在維護舊程式時還有用,但新專案請改用 event.key。原因是 keycode 反映的是實體按鍵位置,會隨鍵盤配置(Dvorak、不同語言鍵盤)而改變,且過去被標示為不建議使用。改用 key 之後,程式碼也變得可讀得多:
document.addEventListener('keydown', function (e) {
if (e.key === 'Enter') { submit(); }
if (e.key === 'Escape') { closeModal(); }
if (e.key.length === 1) { console.log('輸入字元:', e.key); }
});
另外,keypress 事件已被棄用,且不在功能鍵上觸發。判斷「使用者按下了什麼」時,keydown 搭配 event.key 就是現在的標準答案。