矢印キーのキーコード

矢印キーは、event.key「ArrowLeft」「ArrowUp」「ArrowRight」「ArrowDown」と、keyCode 37・38・39・40を送ります。

すべての値の一覧

矢印キーの値
キーevent.codeevent.keykeyCodeevent.location
左矢印ArrowLeftArrowLeft370(標準)
上矢印ArrowUpArrowUp380(標準)
右矢印ArrowRightArrowRight390(標準)
下矢印ArrowDownArrowDown400(標準)

keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。

ここで押してみる

ここをクリックしてから、矢印キーを押してください

キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。

左矢印に反応するコード

おすすめ:event.keyで判定
document.addEventListener('keydown', (event) => {
  if (event.key === 'ArrowLeft') {
    // ここに処理を書きます
  }
});
キーの位置で判定:event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ArrowLeft') {
    // ここに処理を書きます
  }
});
keyCodeを使う古いコード(非推奨)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 37) {
    // ここに処理を書きます
  }
});

どの値を使うか

event.keyを確かめます。矢印キーはキーボード配列によって変わらないので、keyとcodeは同じ名前です:ArrowLeft、ArrowUp、ArrowRight、ArrowDown。

テンキーを数に入れたくないときはevent.codeを使います。Num Lockがオフのとき、テンキーの4、8、6、2も、key「ArrowLeft」「ArrowUp」「ArrowRight」「ArrowDown」とkeyCode 37〜40を送ります。見分けられるのは、code(Numpad4、Numpad8、Numpad6、Numpad2)と、locationの値3だけです。

古い数値は、左から時計回りに37が左、38が上、39が右、40が下です。どのブラウザも今も送りますが、非推奨です。

よくあるつまずき

プレイヤーが矢印キーを押すとページがスクロールする

スクロールは矢印キーのデフォルトの動作です。keydownでevent.preventDefault()を呼んでください。windowではなくゲームの要素そのもの(tabindex="0"を付ける)でイベントを受け取ると、ページのほかの部分はスクロールでき、入力欄でもカーソルを動かせます。

game.addEventListener('keydown', (event) => {
  if (event.key.startsWith('Arrow')) event.preventDefault();
});

動きがカクつく、または方向が押しっぱなしになる

押したままのキーは、keydownを1回送ったあと少し間をおき、ユーザーのリピート速度で繰り返します。keydownのたびに動かすとカクつきます。代わりに、押されているキーの集合を持ちます。keydownでevent.codeを追加し、keyupで削除して、ゲームループの中で動かします。windowのblurイベントで集合を空にしてください。ユーザーがキーを押したままウィンドウを切り替えると、そのkeyupはページに届きません。

古いコードが「Left」や「Up」を確かめている

Internet Explorer、Edge 16以前、Firefox 36以前は、"Left"、"Up"、"Right"、"Down"を送っていました。今のブラウザはArrowの付いた名前を送ります。両方を確かめるのは、まだこれらのブラウザに対応している場合だけです。

矢印キーの処理がスライダー、リスト、入力欄とぶつかる

多くの要素は、自分で矢印キーを使います。入力欄はカーソルを動かし、スライダーは値を変え、ラジオボタンや<select>は選択を変えます。event.targetがこれらの要素のイベントは飛ばすか、先にその要素にキーを処理させてevent.defaultPreventedを確かめてください。

Macとノートパソコンのキーボード

Macのノートパソコンや多くの小さなキーボードには、Home、End、Page Up、Page Downのキーがありません。Macでは、代わりにFnを押しながら矢印キーを押します。Fn + 左がHome、Fn + 右がEnd、Fn + 上がPage Up、Fn + 下がPage Downを送ります。ページに届くのはこれらのキーで、矢印キーではありません。

Macでは、Cmdを押しながら押した矢印キーのkeyupが、どのブラウザでも届かないことがあります。押されているキーの状態を、これに頼って管理しないでください。