文字キーのキーコード(A〜Z)

文字キーは、event.code「KeyA」〜「KeyZ」、US配列ではevent.key「a」〜「z」(ShiftかCaps Lockで「A」〜「Z」)、keyCode 65〜90を送ります。

すべての値の一覧

文字キー(A〜Z)の値
キーevent.codeevent.keykeyCodeevent.location
AKeyAa650(標準)
BKeyBb660(標準)
CKeyCc670(標準)
DKeyDd680(標準)
EKeyEe690(標準)
FKeyFf700(標準)
GKeyGg710(標準)
HKeyHh720(標準)
IKeyIi730(標準)
JKeyJj740(標準)
KKeyKk750(標準)
LKeyLl760(標準)
MKeyMm770(標準)
NKeyNn780(標準)
OKeyOo790(標準)
PKeyPp800(標準)
QKeyQq810(標準)
RKeyRr820(標準)
SKeySs830(標準)
TKeyTt840(標準)
UKeyUu850(標準)
VKeyVv860(標準)
WKeyWw870(標準)
XKeyXx880(標準)
YKeyYy890(標準)
ZKeyZz900(標準)

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

ここで押してみる

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

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

Aに反応するコード

おすすめ:event.keyで判定
document.addEventListener('keydown', (event) => {
  if (event.key === 'a') {
    // ここに処理を書きます
  }
});
キーの位置で判定:event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'KeyA') {
    // ここに処理を書きます
  }
});
keyCodeを使う古いコード(非推奨)
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 + 文字キーのショートカットは避けてください。