文字キーのキーコード(A〜Z)
文字キーは、event.code「KeyA」〜「KeyZ」、US配列ではevent.key「a」〜「z」(ShiftかCaps Lockで「A」〜「Z」)、keyCode 65〜90を送ります。
すべての値の一覧
| キー | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| A | KeyA | a | 65 | 0(標準) |
| B | KeyB | b | 66 | 0(標準) |
| C | KeyC | c | 67 | 0(標準) |
| D | KeyD | d | 68 | 0(標準) |
| E | KeyE | e | 69 | 0(標準) |
| F | KeyF | f | 70 | 0(標準) |
| G | KeyG | g | 71 | 0(標準) |
| H | KeyH | h | 72 | 0(標準) |
| I | KeyI | i | 73 | 0(標準) |
| J | KeyJ | j | 74 | 0(標準) |
| K | KeyK | k | 75 | 0(標準) |
| L | KeyL | l | 76 | 0(標準) |
| M | KeyM | m | 77 | 0(標準) |
| N | KeyN | n | 78 | 0(標準) |
| O | KeyO | o | 79 | 0(標準) |
| P | KeyP | p | 80 | 0(標準) |
| Q | KeyQ | q | 81 | 0(標準) |
| R | KeyR | r | 82 | 0(標準) |
| S | KeyS | s | 83 | 0(標準) |
| T | KeyT | t | 84 | 0(標準) |
| U | KeyU | u | 85 | 0(標準) |
| V | KeyV | v | 86 | 0(標準) |
| W | KeyW | w | 87 | 0(標準) |
| X | KeyX | x | 88 | 0(標準) |
| Y | KeyY | y | 89 | 0(標準) |
| Z | KeyZ | z | 90 | 0(標準) |
keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。
ここで押してみる
ここをクリックしてから、文字キーを押してください
キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。
Aに反応するコード
document.addEventListener('keydown', (event) => {
if (event.key === 'a') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'KeyA') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 65) {
// ここに処理を書きます
}
});どの値を使うか
大事なのが文字なのか、キーボード上の位置なのかで決まります。
入力された文字や、元に戻すCtrl + Zのように文字の名前が付いたショートカットには、event.keyを確かめます。ユーザーの配列に従うので、Zと書かれたキーでショートカットが動きます。
ゲームのWASDのように位置で選んだキーには、event.codeを確かめます。KeyWはどの配列でもSの上にあるキーです。そのキーで「z」が入力されるフランス語のAZERTYキーボードでも同じです。
keyCodeは大文字の番号で、Aの65からZの90までです。Shiftの有無は関係ありません。ラテン文字の配列では、たいてい入力された文字に従います。AZERTYでは、codeがKeyQのキーで「a」が入力され、65が送られます。ロシア語やギリシャ語など、ラテン文字以外の配列では、たいていUS配列でその位置にある文字の番号になります。
よくあるつまずき
event.keyが「a」ではなく「A」になる
ShiftとCaps Lockでevent.keyが変わります。event.key.toLowerCase() === 'a'のように小文字にして比べ、Shiftが大事ならevent.shiftKeyを別に確かめてください。これはMacでも役立ちます。MacではCmd + Shift + Zが小文字の「z」で届くことがあります。
フランス語キーボードでWASD操作が効かない
event.key === 'w'を確かめていると、AZERTYのプレイヤーは左下のWまで指を伸ばすことになります。event.code(KeyW、KeyA、KeyS、KeyD)を確かめれば、キーの位置は同じままです。ヘルプに正しい文字を表示するには、ChromeとEdgeならnavigator.keyboard.getLayoutMap()で、codeのキーが何を入力するかを調べられます。
ドイツ語やフランス語のキーボードでCtrl+Zが別のキーになる
ドイツ語のQWERTZ配列ではZとYが入れ替わっています。AZERTYでは、ZはUS配列のWの位置にあります。event.code === 'KeyZ'で判定したショートカットでは、ドイツ語のユーザーはYと書かれたキーを押すことになります。文字のショートカットはevent.keyで判定してください。
ロシア語やギリシャ語の配列でショートカットが動かなくなる
これらの配列では、event.keyはその文字体系の文字です。ロシア語の配列でCtrl + Zを押すと「я」が送られます。キーがラテン文字でないときは、位置で判定するようにします。
const letter = /^[a-z]$/i.test(event.key)
? event.key.toLowerCase()
: event.code.startsWith('Key') ? event.code.slice(3).toLowerCase() : '';MacでAlt+文字キーを押すと別の文字が入力される
option + Sで「ß」が入力されるので、event.keyは「s」ではなく「ß」になります。option + Eはデッドキーで、event.keyは「Dead」になり、次の文字にアクセントが付きます。Altのショートカットは、event.codeとevent.altKeyで判定してください。Windowsでは、AltGrのある配列がCtrl + Altで同じことをします。ドイツ語キーボードではCtrl + Alt + Eで€が入力されるので、Ctrl + Alt + 文字キーのショートカットは避けてください。