KeyboardEvent keyCode 属性

定义和用法

keyCode 属性返回触发 onkeypress 事件 的按键的 Unicode 字符代码,或触发 onkeydownonkeyup 事件 的按键的 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" 键,请使用 altKeyctrlKey/、metaKeyshiftKey 属性。

实例

例子 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 属性