Keyboard: getLayoutMap() 方法

可用性有限

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

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

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

Keyboard 介面的 getLayoutMap() 方法返回一個 Promise,該 Promise 會解析為一個 KeyboardLayoutMap 例項。KeyboardLayoutMap 是一個類似對映的物件,提供了用於檢索與特定物理鍵相關聯的字串的函式。

語法

js
getLayoutMap()

引數

無。

返回值

一個 Promise,它會解析為一個 KeyboardLayoutMap 例項。

異常

SecurityError DOMException

如果呼叫被 許可權策略 阻止,則丟擲此異常。

示例

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

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

規範

規範
鍵盤對映
# h-keyboard-getlayoutmap

瀏覽器相容性

另見