Keyboard

Limited availability

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

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

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

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

インスタンスプロパティ

なし。

インスタンスメソッド

Keyboard.getLayoutMap() Experimental: 特定の物理キーに関連付けられた文字列を取得するための関数を持つ、マップ風のオブジェクトである KeyboardLayoutMap のインスタンスに解決するプロミス (Promise) を返します。
Keyboard.lock() Experimental: 物理キーボード上の任意のキーまたはすべてのキーのキー押下のキャプチャを有効にした後、 Promise を返します。
Keyboard.unlock() Experimental: lock()メソッドでキャプチャしたすべてのキーのロックを解除し、同期的に返します。

例

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

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.
}

仕様書

Specification
Keyboard Map # keyboard-interface
Keyboard Lock # keyboard-interface

ブラウザーの互換性

BCD tables only load in the browser