KeyboardEvent which 屬性

DOM 事件 KeyboardEvent

定義和用法

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

兩種代碼類型的區別：

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

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

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

注釋：IE8 及更早版本不支持 which 屬性。對于這些瀏覽器版本，您可以使用 keyCode 屬性。但是，keyCode 屬性對 Firefox 中的 onkeypress 事件不起作用。為了跨瀏覽器解決方案，您可以使用如下代碼：

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

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

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

注釋：該屬性只讀。

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

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

實例

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

var x = event.which;

頁面下方有更多 TIY 實例。

親自試一試

語法

event.which

技術細節

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

瀏覽器支持

表中的數字注明了完全支持該屬性的首個瀏覽器版本。

屬性 Chrome IE Firefox Safari Opera
which 支持 9.0 支持 支持 支持

更多實例

實例

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

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

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

Unicode CHARACTER code: 97
Unicode KEY code: 65

親自試一試

實例

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

<input type="text" onkeydown="myFunction(event)"> 
function myFunction(event) {
  var x = event.which || event.keyCode; // event.keyCode 用于 IE8 及更早版本
  if (x == 27) {  // 27 is the ESC key
    alert ("You pressed the Escape key!");
  }
}

親自試一試

實例

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

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

親自試一試

相關頁面

HTML DOM 參考手冊：KeyboardEvent key 屬性

HTML DOM 參考手冊：KeyboardEvent keyCode 屬性

HTML DOM 參考手冊：KeyboardEvent charCode 屬性

DOM 事件 KeyboardEvent