KeyboardEvent.location

KeyboardEvent.location は読み取り専用のプロパティで、キーボードやその他の入力機器上のキーの位置を表す unsigned long を返します。

取りうる値は以下の通りです。

定数 説明
DOM_KEY_LOCATION_STANDARD 0 このキーは 1 つしかない、または左右の区別がつかないもので、テンキーやキーパッドの一部とみなされるキーで押されたものではありません。
DOM_KEY_LOCATION_LEFT 1 このキーは、左側のキーです。例えば、標準的な 101 キーの US キーボードでは、左側の Control キーが押されたことになります。この値は、キーボード上に 2 つ以上の位置にある可能性があるキーにのみ使用されます。
DOM_KEY_LOCATION_RIGHT 2 このキーは、右側のキーです。例えば、標準的な 101 キーの US キーボードでは、右側の Control キーが押されたことになります。この値は、キーボード上に 2 つ以上の位置にある可能性があるキーにのみ使用されます。
DOM_KEY_LOCATION_NUMPAD 3

キーがテンキーにあるか、テンキーに対応する仮想キーコードを持っています。

メモ: NumLock がロックされているとき、Gecko はテンキーのキーに対して常に DOM_KEY_LOCATION_NUMPAD を返します。一方、NumLock がロックされていない場合、キーボードに実際にテンキーがある場合にも、 Gecko は常に DOM_KEY_LOCATION_NUMPAD を返します。一方、ノートパソコンのようにキーボードにテンキーがない場合、 NumLock がロックされたときだけテンキーとなるキーがあります。このようなキーがキーイベントを発行する場合、 location 属性の値はキーに依存します。つまり、 DOM_KEY_LOCATION_NUMPAD になることはありません。

メモ: NumLock キーのキーイベントは、 Gecko と Internet Explorer の両方で DOM_KEY_LOCATION_STANDARD となります。

DOM_KEY_LOCATION_MOBILE Non-Standard Deprecated 4

キーはモバイル機器にあります。これは物理的なキーパッドでも仮想キーボードでもかまいません。

Note: Gecko では DOM_KEY_LOCATION_MOBILE を Android (18 以前)、Maemo、Boot to Geckoで常に返します。しかし、 Gecko 38 では、これは削除されました。

DOM_KEY_LOCATION_JOYSTICK Non-Standard Deprecated 5

このキーは、ゲーム機のコントローラーのボタンやモバイル機器のジョイスティックです。

メモ: Gecko は Android 以外では DOM_KEY_LOCATION_JOYSTICK を持つ信頼されるイベントを発行しません。 18 からは、Android 上のネイティブのキーイベントがこの値を持つ可能性があります。しかし、 Gecko 38 で、この値は削除されました。

数値です。

function keyEvent(event) {
  console.log("押されたキーの位置: " + event.location);
}

仕様書

Specification
UI Events
# dom-keyboardevent-location

ブラウザーの互換性

BCD tables only load in the browser

関連情報