说明文档

什么是键盘按键检测

键盘按键检测用于实时查看当前键盘事件中的 key、keyCode、code、location 和组合键状态，适合做 KeyCode 键值查询、快捷键排查和键盘映射核对。

如何使用本工具

  1. 打开页面后，直接在当前页面按下任意键。
  2. 工具会立即刷新当前按键、KeyCode、Code、Location 和 Modifiers。
  3. 点击任意字段右侧的“复制”按钮，可单独复制对应结果。
  4. 点击“复制全部字段”可一次性复制完整按键信息。
  5. 下方文档区域可查看字段说明与含义，以及 Location 位置说明。

字段说明与含义

  • key：当前按键的字符值或功能键名称。
  • keyCode：旧版兼容键值字段，适合老项目调试。
  • code：物理键位代码，适合键位映射和快捷键绑定。
  • modifiers：当前事件同时按下的组合修饰键。

Location 位置说明

  • 0：标准区，主键盘区的大多数字母、数字、方向键和常规功能键。
  • 1：左侧，左 Shift、左 Ctrl、左 Alt 等带左右区分的按键。
  • 2：右侧，右 Shift、右 Ctrl、右 Alt 等带左右区分的按键。
  • 3：数字键盘，小键盘区域按键，例如 Numpad1、NumpadEnter。

适用场景

  • 前端键盘事件开发与调试
  • 浏览器快捷键冲突排查
  • Web 游戏按键映射测试
  • 表单热键与后台快捷操作验证

注意事项

  • 按住 Ctrl、Shift、Alt 或 Meta 时，Modifiers 会同步显示组合键信息。
  • 排查快捷键冲突时，建议同时关注 key 与 code，避免输入法或键盘布局带来误判。
  • keyCode 适合兼容旧代码，新的开发项目建议优先使用 key 和 code。

隐私与兼容性

本工具全部在浏览器本地运行，不会上传你的按键数据。keyCode 属于历史兼容字段，新项目建议优先使用 key 和 code。