浏览器与 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(),避免无条件阻止正常输入。

html
<!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>

预期结果

text
在文本框中输入内容后:
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 和监听器是否重复注册。页面组件反复挂载却没有移除旧监听器,也会造成一次按键执行多次业务逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

键盘事件与快捷键

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通