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

--- title: "Keyboard Layout Map：getLayoutMap 与键盘布局适配" keywords: - keyboard.getLayoutMap - 物理键与字符 - 布局适配 - 国际化 - 快捷键 description: "介绍 Keyboard API 的布局映射，区分物理键位与字符输出，适配不同语言与键盘布局的快捷键与输入逻辑，提供示例与回退。" categories: - 应用软件 - 输入法 --- 概述 `navigator.keyboard.getLayoutMap()` 返回从键码到字符的映射，帮助根据当前布局设置快捷键与输入规则。适用于国际化应用与复杂编辑器。 示例 ```js 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/