key 事件属性

事件对象参考手册 事件对象

按下按键时获取键盘按钮：

<p>在输入框中按下任意按钮按键。</p>
<input type="text" size="40" onkeydown="myFunction(event)">
<p id="demo"></p>
<p><strong>注意：</strong> 目前只有 Firefox ，IE9及以上版本支持 key 属性。</p>
<script>
  function myFunction(event) {
    var x = event.key;
    document.getElementById("demo").innerHTML = "按键为: " + x;
  }
</script>

尝试一下 »

本文底部包含了更多实例。

定义和使用

key 事件在按下按键时返回按键的标识符。

按键标识符是表示键盘按钮的字符串，该属性的返回值可以是：

  • 单个字母 (如 "a", "W", "4", "+" 或 "$")
  • 多个字母 (如 "F1", "Enter", "HOME" 或 "CAPS LOCK")

提示： 如果你想查看是否按下了 "ALT", "CTRL", "META" 或 "SHIFT" 键，可使用 altKey, ctrlKey, metaKey 或 shiftKey 属性。

浏览器支持

表格中的数字表示支持该属性的第一个浏览器的版本号。

属性
key 不支持 9.0 23.0 不支持 不支持

语法

event.key

技术细节

返回值： 字符串，表示按键按钮。

可能值：
  • 单个字母 (如 "a", "W", "4", "+" 或 "$")
  • 多个字母 (如 "F1", "Enter", "HOME" 或 "CAPS LOCK")
注意： Chrome，Safari 和 Opera浏览器返回 undefined
DOM 版本: DOM Level 3 Events

更多实例

在用户按下 "A" 键时弹出提示信息:

<p>在用户按下 "A" 键时弹出提示信息。</p>
<input type="text" size="40" onkeydown="myFunction(event)">
<p><strong>注意：</strong> 目前只有 Firefox ，IE9及以上版本支持 key 属性。</p>
<script>
  function myFunction(event) {
    var x = event.key;
    // 按下 "a" 或 "A" 键 (使用 caps lock 或 shift)，弹出提示信息
    if (x == "a" || x == "A") {
      alert("你按下了 'A' 键!");
    }
  }
</script>

尝试一下 »

相关页面

HTML DOM 参考手册: key 事件属性

HTML DOM 参考手册: charCode 事件属性

HTML DOM 参考手册: which 事件属性

事件对象参考手册 事件对象