KeyboardEvent key 属性

DOM 事件 KeyboardEvent

定义和用法

key 属性返回发生按键事件时按下的键的标识符。

按键标识符是标识键盘按钮的字符串。此属性的返回值可以是以下字符串：

  • 单个字符（比如 "a", "W", "4", "+" 或 "$"）
  • 多字符（比如 "F1", "Enter", "HOME" 或 "CAPS LOCK"）

注释：该属性只读。

提示：如果您想知道在发生按键事件时是否按下了 "ALT"、"CTRL"、"META" 或 "SHIFT" 键，请使用 altKey、ctrlKey、metaKey 或 shiftKey 属性。

实例

例子 1

获取发生按键事件时按下的键盘按钮：

var x = event.key;

亲自试一试

例子 2

如果用户按下 "A" 键，则提示一些文本：

var x = event.key;

// 如果按下的键盘按钮是 "a" 或 "A"（使用 CapsLock 或 Shift），则提示一些文本。

if (x == "a" || x == "A") { 
  alert ("You pressed the 'A' key!");
}

亲自试一试

语法

event.key

技术细节

返回值：

字符串，代表按下的键盘按钮。

可能的值：

  • 单个字符（比如 "a", "W", "4", "+" 或 "$"）
  • 多字符（比如 "F1", "Enter", "HOME" 或 "CAPS LOCK"）

注释：在 Safari 中返回未定义。
DOM 版本： DOM Level 3

浏览器支持

表中的数字注明了完全支持该属性的首个浏览器版本。

属性 Chrome IE Firefox Safari Opera
key 51.0 9.0 23.0 不支持 38.0

相关页面

HTML DOM 参考手册：KeyboardEvent keyCode 属性

HTML DOM 参考手册：KeyboardEvent which 属性

HTML DOM 参考手册：KeyboardEvent charCode 属性

DOM 事件 KeyboardEvent