浏览器与 Web API / 系统课时
键盘事件与快捷键
键盘事件与快捷键
键盘交互不仅用于输入文字,还承担提交、保存、取消和导航等高频操作。本课将区分 keydown、keyup、key 与 code,并实现兼容 Windows 和 macOS 的编辑器快捷键。
学习目标
- 理解
keydown、keyup与按键自动重复的差异 - 正确选择
key、code和修饰键属性 - 实现带默认行为控制、输入法保护和作用域限制的快捷键
键盘事件的执行方式
keydown 在按键被按下时触发,长按时通常会重复触发;keyup 在按键释放时触发,一般不会重复。需要立即响应的保存、提交和方向控制通常放在 keydown 中,需要确认“按键已经松开”的逻辑再使用 keyup。
事件的 repeat 属性可以识别自动重复。连续移动光标时可以接受重复,但保存、删除记录等一次性动作应在 event.repeat 为 true 时直接返回,避免长按产生多次副作用。
当用户使用中文、日文等输入法组合文字时,键盘事件可能处于合成阶段。此时 event.isComposing 为 true,快捷键处理器通常应暂时退出,避免把输入法确认键误判为提交操作。
key、code 与修饰键
| 属性 | 表示内容 | 适合场景 |
|---|---|---|
key |
按当前布局和修饰键得到的含义,如 s、S、Enter |
保存、提交、关闭等语义快捷键 |
code |
物理键位,如 KeyS、ArrowUp |
游戏控制、固定键位操作 |
ctrlKey |
Windows、Linux 常用控制键状态 | Ctrl+S 等组合键 |
metaKey |
macOS Command 键状态 | Command+S 等组合键 |
altKey、shiftKey |
Alt 与 Shift 状态 | 扩展组合条件 |
repeat |
当前 keydown 是否由长按重复产生 |
防止动作重复执行 |
面向文字编辑器时应优先比较 key,因为它表达用户输入的语义。面向游戏的 WASD 操作时,使用 code 更接近物理位置,不会因键盘布局变化而改变控制区域。
不要再使用已废弃的 keyCode。它对不同浏览器、键盘布局和输入法的表达不够稳定,也无法清楚区分语义字符与物理键位。
实现跨平台快捷键
下面的完整页面实现三个操作:Ctrl/Command+S 保存草稿,Ctrl/Command+Enter 提交内容,Escape 取消当前操作。处理器只在命中自定义快捷键时调用 preventDefault(),避免无条件阻止正常输入。
<!doctype html>
<html lang='zh-CN'>
<head>
<meta charset='utf-8'>
<meta name='viewport' content='width=device-width, initial-scale=1'>
<title>键盘快捷键</title>
<style>
#editor {
width: min(90vw, 640px);
}
textarea {
width: 100%;
min-height: 180px;
box-sizing: border-box;
}
</style>
</head>
<body>
<section id='editor'>
<textarea id='content' placeholder='输入内容后使用快捷键'></textarea>
<p id='status'>尚未执行操作</p>
</section>
<script>
const editor = document.querySelector('#editor');
const content = document.querySelector('#content');
const status = document.querySelector('#status');
function usesPrimaryModifier(event) {
return event.ctrlKey || event.metaKey;
}
editor.addEventListener('keydown', (event) => {
// 输入法正在组合文字时,不执行编辑器快捷键
if (event.isComposing) return;
const normalizedKey = event.key.toLowerCase();
if (
usesPrimaryModifier(event) &&
normalizedKey === 's' &&
!event.repeat
) {
event.preventDefault();
localStorage.setItem('draft', content.value);
status.textContent = '草稿已保存';
return;
}
if (
usesPrimaryModifier(event) &&
event.key === 'Enter' &&
!event.repeat
) {
event.preventDefault();
status.textContent =
content.value.trim() ? '内容已提交' : '请输入内容';
return;
}
if (event.key === 'Escape') {
status.textContent = '操作已取消';
}
});
content.focus();
</script>
</body>
</html>预期结果
在文本框中输入内容后:
Ctrl+S 或 Command+S 显示“草稿已保存”,并把文本写入 localStorage。
Ctrl+Enter 或 Command+Enter 在有内容时显示“内容已提交”。
按 Escape 显示“操作已取消”,普通文字输入不受影响。本例把监听器绑定到 #editor,事件通过冒泡到达该区域,因此快捷键只在焦点位于编辑器内部时生效。若绑定到 window 或 document,快捷键会影响整个页面,应额外判断焦点位置和业务状态。
默认行为与作用域边界
浏览器和操作系统已经占用许多组合键。只有应用确实接管某个操作时才调用 preventDefault(),并避免覆盖刷新、关闭窗口、地址栏聚焦等关键快捷键。某些系统级组合键无法被网页拦截,这是正常的安全边界。
快捷键命中前应检查元素类型。全局字母快捷键如果在 input、textarea 或可编辑区域中执行,可能妨碍用户输入;编辑器专属快捷键则可以限定在编辑器容器中。作用域越小,冲突越少。
组合键判断应把 macOS 的 metaKey 与其他平台的 ctrlKey 视为主修饰键,但不要简单忽略 altKey 和 shiftKey。当某个快捷键要求精确组合时,应显式确认未按下多余修饰键,防止与其他功能重叠。
验证与排查
快捷键无响应时,先在监听器中临时输出 event.key、event.code、修饰键和 event.isComposing,确认浏览器实际收到的值。随后检查焦点是否位于监听区域、事件是否被子元素提前停止传播,以及默认行为是否在命中前就被阻止。
同一个按键触发多次时,重点检查 event.repeat 和监听器是否重复注册。页面组件反复挂载却没有移除旧监听器,也会造成一次按键执行多次业务逻辑。