KeyboardLayoutMap

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

KeyboardLayoutMap 介面是 Keyboard API 的一部分,它是一個只讀物件,提供用於檢索與特定物理按鍵關聯的字串的函式。

KeyboardLayoutMap 例項是一個只讀的 Map 物件,其中每個鍵是一個字串,用於標識鍵盤上唯一的物理按鍵(“鍵碼”),而對應的值是關聯的按鍵屬性值(可能受到鍵盤佈局等因素的影響)。

有效鍵的列表可以在 UI Events KeyboardEvent code Values 規範中找到。

例項屬性

KeyboardLayoutMap.size 只讀 實驗性

返回 KeyboardLayoutMap 物件中的元素數量。

例項方法

KeyboardLayoutMap[Symbol.iterator]() 實驗性

返回一個包含鍵/值對的新 Iterator 物件。

KeyboardLayoutMap.entries() 實驗性

返回一個包含鍵/值對的新 Iterator 物件。

KeyboardLayoutMap.forEach() 實驗性

KeyboardLayoutMap 的每個元素執行一次提供的函式。

KeyboardLayoutMap.get() 實驗性

KeyboardLayoutMap 物件中返回具有給定鍵的元素。

KeyboardLayoutMap.has() 實驗性

返回一個布林值,指示 KeyboardLayoutMap 物件是否具有指定鍵的元素。

KeyboardLayoutMap.keys() 實驗性

返回一個包含 KeyboardLayoutMap 物件中每個索引的鍵的新 Iterator 物件。

KeyboardLayoutMap.values() 實驗性

返回一個包含 KeyboardLayoutMap 物件中每個索引的值的新 Iterator 物件。

示例

以下示例演示瞭如何獲取與英文 QWERTY 鍵盤上的 'W' 鍵對應的鍵碼相關的、特定於位置或佈局的字串。

js
navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  const upKey = keyboardLayoutMap.get("KeyW");
  window.alert(`Press ${upKey} to move up.`);
});

規範

規範
鍵盤對映
# keyboardlayoutmap-interface

瀏覽器相容性