矢印キーのキーコード
矢印キーは、event.key「ArrowLeft」「ArrowUp」「ArrowRight」「ArrowDown」と、keyCode 37・38・39・40を送ります。
すべての値の一覧
| キー | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| 左矢印 | ArrowLeft | ArrowLeft | 37 | 0(標準) |
| 上矢印 | ArrowUp | ArrowUp | 38 | 0(標準) |
| 右矢印 | ArrowRight | ArrowRight | 39 | 0(標準) |
| 下矢印 | ArrowDown | ArrowDown | 40 | 0(標準) |
keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。
ここで押してみる
ここをクリックしてから、矢印キーを押してください
キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。
左矢印に反応するコード
document.addEventListener('keydown', (event) => {
if (event.key === 'ArrowLeft') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'ArrowLeft') {
// ここに処理を書きます
}
});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が、どのブラウザでも届かないことがあります。押されているキーの状態を、これに頼って管理しないでください。