JavaScript 中应优先使用 event.key 获取语义键值、event.code 获取物理按键标识,并通过 shiftKey、ctrlKey、altKey、metaKey 布尔属性判断组合键状态;keydown 事件最适合快捷键检测。

在 JavaScript 中,通过事件对象的属性可以准确获取用户按下的键值以及是否同时按下 Shift、Ctrl、Alt、Meta(如 Windows 键或 Command 键)等组合键。
获取按键的键值:key、code 与 keyCode 的区别
key 返回按键的“语义值”,比如按下 A 键(无论是否按住 Shift),event.key 是 "a" 或 "A";按下回车键是 "Enter";按下方向键是 "ArrowUp" 等。它反映的是用户意图输入的字符或功能含义,推荐优先使用。
code 返回物理按键的标识,与键盘布局无关。例如,不管是否按 Shift,按下左上角字母区的“A”键,event.code 始终是 "KeyA";按下右侧 Ctrl 键,是 "ControlRight"。适合做快捷键绑定(如 Ctrl+S),避免因大小写或输入法干扰。
keyCode 已被废弃,不建议使用;现代代码应避免依赖它。
立即学习“Java免费学习笔记(深入)”;
判断组合键状态:用布尔属性直接读取
事件对象提供多个只读布尔属性,用于判断修饰键是否处于按下状态:
-
event.shiftKey—— Shift 键是否被按下 -
event.ctrlKey—— Ctrl 键(Windows/Linux)或 Control 键(Mac)是否被按下 -
event.altKey—— Alt 键(Windows/Linux)或 Option 键(Mac)是否被按下 -
event.metaKey—— Meta 键(Mac 上是 Command ⌘,Windows 上通常是 Windows 键)是否被按下
这些属性在 keydown、keyup、keypress(已废弃)等事件中都可用,且实时反映当前修饰键状态,无需额外监听。
典型快捷键检测写法示例
比如监听“Ctrl+S”保存操作:
document.addEventListener('keydown', (e) => {
if (e.ctrlKey && e.key === 's') {
e.preventDefault(); // 阻止浏览器默认保存行为
console.log('触发自定义保存逻辑');
}
});
注意:e.ctrlKey 在 Mac 上对应 Command 键,因此该写法在 Mac 上实际响应的是 ⌘+S,符合用户预期。若需严格区分 Ctrl 和 Meta(如仅响应 Ctrl+S 不响应 ⌘+S),可改用 e.key === 's' && e.ctrlKey && !e.metaKey。
注意事项与兼容性提醒
keydown 是检测按键组合最可靠的时机,因为此时所有修饰键和主键状态均已生效;keypress 已被标准弃用,且不支持功能键(如 F1、ArrowLeft);input 或 keyup 不适合快捷键判断——前者无修饰键信息,后者可能错过组合键释放顺序。
对于需要跨平台一致行为的快捷键(如“保存”、“新建”),优先用 key + 修饰键属性;若需绑定到特定物理键(如游戏控制方向键),则用 code 更稳定。


















