按下键盘上的任意键

正在监听键盘输入...

event.key -

event.code -

event.which -

event.location -

JavaScript 代码片段

window.addEventListener("keydown", (e) => {
  if (e.key === "-") {
    // 逻辑处理
  }
});

JS KeyCode 指南：深入理解键盘事件属性

在 Web 开发中，处理键盘交互是提升用户体验的关键。无论是实现快捷键、游戏控制，还是自定义输入行为，开发者都需要精准捕获按键信息。然而，随着 Web 标准的演进， keyCode 这一曾经的主流属性已逐渐被废弃。本工具旨在帮助开发者实时查看现代与传统的按键属性，并提供标准的代码参考。

event.key (推荐)： 返回按键产生的字符值。例如，按下 Shift + a 会返回 "A" 。它是处理文本输入的首选。
event.code (推荐)： 返回按键的物理位置。例如，左侧的 Shift 和右侧的 Shift 对应的 code 分别是 "ShiftLeft" 和 "ShiftRight" 。它是处理快捷键和游戏控制的首选。
event.keyCode (已废弃)： 返回按键的数字代码。由于跨浏览器兼容性差且不直观，W3C 已将其标记为废弃，不建议在新项目中使用。

现代 Web 开发应优先监听 keydown 事件，并使用 event.key 进行逻辑判断。如果您的应用需要区分物理位置（如游戏 WASD 键），则应使用 event.code 。本工具下方的代码片段会自动根据您按下的键生成对应的监听模板，您可以直接复制使用。

Meta 键： 在 Windows 上是 Windows 键，在 Mac 上是 Command 键。
Location 属性： 0 代表标准位置， 1 代表左侧， 2 代表右侧， 3 代表数字键盘区。
组合键检测： 通过 e.ctrlKey , e.shiftKey , e.altKey , e.metaKey 布尔值来判断是否按下了修饰键。

如果您发现某个按键在您的应用中没有响应，或者在不同操作系统下表现不一致，请打开本页面并按下该键。您可以立即对比其 key 和 code 值，排查是否存在兼容性逻辑错误。例如，某些多媒体键或国际化键盘的 keyCode 往往不可靠。

Q: 为什么某些系统快捷键（如 Ctrl+W）无法显示？
A: 浏览器会优先处理某些危险的系统级快捷键以确保用户安全。这些事件通常无法被网页 JS 捕获或阻止。

Q: 移动端软键盘支持这些属性吗？
A: 软键盘的行为与物理键盘完全不同。在移动端，建议监听 input 事件或使用专门的文本处理逻辑，而不是依赖键盘事件属性。