DOM

KeyboardEvent.location プロパティ

 編集:2022.10.13 by T.A.

[Edge]。読取専用。→

KeyboardEvent が発生したときに、キーボードやその他の入力機器上のキーの位置を unsigned long の数値で示します。

構文
KeyboardEvent.location
KeyboardEvent KeyboardEvent

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 4 非標準 非推奨。キーはモバイル機器にあります。これは物理的なキーパッドでも仮想キーボードでもかまいません。

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

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

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

keydown イベントで各種表示

HTML:

<SPAN id=IdTest contenteditable>[SPAN要素。ここで編集操作…]</SPAN><BR>
<SPAN id=IdLog></SPAN>

JavaScript:

function JobDown(eve){ //keydown イベントの処理:
  D=eve;
  IdLog.innerHTML=IdLog.innerHTML + eve.key +":"+ eve.location +"、"; //表示。
}
IdTest.onkeydown=JobDown;  //イベント割り当て。

Element:keydowninnerHTML


テスト