このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Keyboard

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

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

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

Keyboard はキーボード API のインターフェイスで、キーボードレイアウトマップを取得し、物理キーボードからのキー押下のキャプチャを切り替える関数を提供します。 有効なコード値のリストは UI Events KeyboardEvent code Values 仕様にあります。

EventTarget Keyboard

インスタンスプロパティ

なし。

インスタンスメソッド

Keyboard.getLayoutMap()

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

Keyboard.lock()

物理キーボード上の任意のキーまたはすべてのキーのキー押下のキャプチャを有効にした後、 Promise を返します。

Keyboard.unlock()

lock()メソッドでキャプチャしたすべてのキーのロックを解除し、同期的に返します。

例

次の例は、英語の QWERTY キーボードの 'W' キーに対応するキーに関連付けられた、場所またはレイアウト固有の文字列を取得する方法を示しています。

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

仕様書

仕様書
Keyboard Map
# keyboard-interface
Keyboard Lock
# keyboard-interface

ブラウザーの互換性