KeyboardEvent keyCode 屬性

DOM 事件 KeyboardEvent

定義和用法

keyCode 屬性返回觸發 onkeypress 事件 的按鍵的 Unicode 字符代碼，或觸發 onkeydown 或 onkeyup 事件 的按鍵的 Unicode 按鍵代碼。

兩種代碼類型的區別：

  • 字符代碼 - 代表 ASCII 字符的數字
  • 按鍵代碼 - 代表鍵盤上實際鍵的數字

這些類型并不總是意味著同樣的事情。例如，小寫 "w" 和大寫 "W" 的鍵盤代碼相同，因為在鍵盤上按下的鍵是相同的（"W" = 數字 "87"），但字符代碼不同，因為 resulting 字符是不同的（"w" 或 "W"，即 "119" 或 "87"）- 請查看下面的更多實例，可以對這一點有更好的理解。

提示：如需了解用戶是否按下了可打印的鍵（例如 "a" 或 "5"），建議在 onkeypress 事件上使用此屬性。要了解用戶是否按下了功能鍵（例如 "F1"、"CAPS LOCK" 或 "Home"），請使用 onkeydown 或 onkeyup 事件。

注釋：在 Firefox 中，keyCode 屬性對 onkeypress 事件不起作用（只會返回 0）。為了跨瀏覽器的解決方案，請將 which 屬性與 keyCode 一起使用，例如：

var x = event.which || event.keyCode;  // 使用 which 還是 keyCode，取決于瀏覽器支持

提示：有關所有 Unicode 字符的列表，請參閱我們的 完整 Unicode 參考。

提示：如果要將 Unicode 值轉換為字符，請使用 fromCharCode() 方法。

注釋：該屬性只讀。

注釋：提供 keyCode 和 which 屬性只是為了兼容性。最新版本的 DOM 事件規范建議使用 key 屬性代替（如果可用）。

提示：如果您想知道在發生按鍵事件時是否按下了 "ALT"、"CTRL"、"META" 或 "SHIFT" 鍵，請使用 altKey、ctrlKey/、metaKey 或 shiftKey 屬性。

實例

例子 1

獲取按下的鍵盤按鍵的 Unicode 值：

var x = event.keyCode;

親自試一試

例子 2

使用 onkeypress 和 onkeydown 來演示字符代碼與鍵盤代碼之間的區別：

<input type="text" onkeypress="uniCharCode(event)" onkeydown="uniKeyCode(event)"> 
function uniCharCode(event) {
  var char = event.which || event.keyCode;
  document.getElementById("demo").innerHTML = "Unicode CHARACTER code: " + char;
}
function uniKeyCode(event) {
  var key = event.keyCode;
  document.getElementById("demo2").innerHTML = "Unicode KEY code: " + key;
}

按鍵盤上的 "a" 鍵（不使用 Capslock）時，char 和 key 的結果將是：

Unicode CHARACTER code: 97
Unicode KEY code: 65

親自試一試

例子 3

如果用戶按下 Escape 鍵，則提示一些文本：

<input type="text" onkeydown="myFunction(event)"> 
function myFunction(event) {
  var x = event.keyCode;
  if (x == 27) {  // 27 是 ESC 鍵
    alert ("You pressed the Escape key!");
  }
}

親自試一試

例子 4

將 Unicode 值轉換為字符（不適用于功能鍵）：

var x = event.keyCode;                // 獲取 Unicode 值
var y = String.fromCharCode(x);       // 將值轉換為字符

親自試一試

語法

event.keyCode

技術細節

返回值： 數字值，表示 Unicode 字符代碼或 Unicode 按鍵代碼。
DOM 版本： DOM Level 2 Events

瀏覽器支持

屬性 Chrome IE Firefox Safari Opera
keyCode 支持 支持 支持 支持 支持

相關頁面

HTML DOM 參考手冊：KeyboardEvent key 屬性

HTML DOM 參考手冊：KeyboardEvent charCode 屬性

HTML DOM 參考手冊：KeyboardEvent which 屬性

DOM 事件 KeyboardEvent