DOM

インターフェイス

KeyboardEvent.code プロパティ

[Edge]。→●、mdn、mdn（en-US）

KeyboardEvent が発生した時の、（キー入力によって入力された文字ではなく）キーボード上の物理的なキーを表す文字列を示します。

つまり、このプロパティはキーボード レイアウトや修飾キーの状態によって変更される前の値を返します。

入力機器が物理キーボードではなく、仮想キーボードやアクセシビリティ機器である場合、返値は物理キーボードから入力された場合にできるだけ近づくよう、物理キーボードと仮想入力機器との互換性を最大にするよう、ブラウザーによって設定されます。

このプロパティは、キーに関連付けられている文字ではなく、入力機器上の物理的な位置に基づいてキー入力を扱いたいときに役立ちます。これは特に、キーボードをゲームパッドのように使いたい場合などに有用です。ただし、KeyboardEvent.code で報告された値を用いてキー入力で生成される文字を判断するべきではありません。キーコード名がキー上に印刷されている実際の文字や、キーが押されたときにコンピューターが生成する文字と一致するとは限らないからです。

例えば、返ってきた code が "KeyQ" は QWERTY レイアウトのキーボードでは Qキーですが、同じ Dvorak キーボードでは同じ code の値が 'キーを表し、AZERTY キーボードでは Aキーを表すものでもあります。したがって、すべてのユーザーが特定のキーボード レイアウトを使用しているわけではないため、code の値を用いてユーザーが認識しているキーの名前が何であるかを特定することはできません。

構文

値

¶文字列。Windows、Linux、macOS におけるコード値は、KeyboardEvent：コード値（en-US）のページにあります。

例

mdn

→mdn

keydown イベントで各種表示

<SPAN id=IdTest1 contenteditable>[SPAN要素。ここで編集操作…]</SPAN><BR>
<INPUT id=IdTest2 type=text><BR>
<SPAN id=IdLog></SPAN>

function Job(eve){ //keydown イベントの処理：
  D=eve;
  IdLog.innerHTML="key："+ eve.key +"<BR>"
	+"code："+ eve.code +"<BR>"
	+"shiftKey："+ eve.shiftKey +"<BR>"
	+"ctrlKey："+ eve.ctrlKey +"<BR>"
	+"altKey："+ eve.altKey +"<BR>"
	+"metaKey："+ eve.metaKey;  //表示。
}
IdTest1.onkeydown=Job;  //イベント割り当て。
IdTest2.onkeydown=Job;  //イベント割り当て。

テスト