Keyboard: getLayoutMap() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

getLayoutMap() は Keyboard インターフェイスのメソッドで、特定の物理キーに関連付けられた文字列を取得するための関数を持つマップ風のオブジェクトである KeyboardLayoutMap のインスタンスで解決するプロミス (Promise) を返します。

構文

js
getLayoutMap()

引数

なし。

返値

KeyboardLayoutMap のインスタンスで解決するプロミス (Promise) です。

例外

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.`);
});

仕様書

Specification
Keyboard Map
# h-keyboard-getlayoutmap

ブラウザーの互換性

BCD tables only load in the browser