"Keyboard Layout Map：getLayoutMap 与键盘布局适配"

---

title: "Keyboard Layout Map：getLayoutMap 与键盘布局适配"

keywords:

• keyboard.getLayoutMap
• 物理键与字符
• 布局适配
• 国际化
• 快捷键

description: "介绍 Keyboard API 的布局映射，区分物理键位与字符输出，适配不同语言与键盘布局的快捷键与输入逻辑，提供示例与回退。"

categories:

• 应用软件
• 输入法

---

概述

navigator.keyboard.getLayoutMap() 返回从键码到字符的映射，帮助根据当前布局设置快捷键与输入规则。适用于国际化应用与复杂编辑器。

示例

const map = await navigator.keyboard.getLayoutMap()
console.log(map.get('KeyZ')) // 当前布局下的 Z 键字符

工程建议

• 快捷键设计：避免硬编码字符；基于物理键或布局映射设置快捷键。
• 兼容：不支持时回退到键盘事件与 locale 推断；允许用户自定义绑定。
• 安全与权限：需用户手势或权限策略；处理隐私边界。

参考与验证

• MDN Keyboard API 文档：https://developer.mozilla.org/docs/Web/API/Keyboard_API
• Chrome 平台文档（Layout Map）：https://developer.chrome.com/docs/web-platform/keyboard-map/