数字キーのキーコード(0〜9)

文字キーの上にある数字キーは、event.code「Digit0」〜「Digit9」、US配列ではevent.key「0」〜「9」、keyCode 48〜57を送ります。

すべての値の一覧

数字キー(0〜9)の値
キーevent.codeevent.keykeyCodeevent.location
0Digit00480(標準)
1Digit11490(標準)
2Digit22500(標準)
3Digit33510(標準)
4Digit44520(標準)
5Digit55530(標準)
6Digit66540(標準)
7Digit77550(標準)
8Digit88560(標準)
9Digit99570(標準)

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

ここで押してみる

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

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

0に反応するコード

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

どの値を使うか

入力された数字に反応するには、event.keyを/^[0-9]$/.test(event.key)のように確かめます。これで、上の列の数字キーとテンキー(Num Lockがオンのとき)の両方を、数字を入力するどの配列でも受け付けられます。

ゲームで「1〜5を押して枠を選ぶ」のように位置が大事なときは、event.code(Digit1)を使います。codeはどの配列でも同じです。Shiftなしでは別の文字が入力される配列でも変わりません。

keyCodeの48〜57は上の列だけです。テンキーは同じ数字に96〜105を送るので、48〜57で判定するとテンキーを見逃します。

よくあるつまずき

フランス語キーボードから数字が届かない

Windowsのフランス語のAZERTYキーボードでは、上の列でShiftなしに入力されるのは & é “ ’ ( - è _ ç à です。数字にはShiftが必要です。そのため、Digit2を押すとevent.keyは「é」になりますが、WindowsのChromeとFirefoxではkeyCodeは50のままです。入力された数字は、入力欄の値かevent.keyで読んでください。「1を押す」ショートカットはevent.codeで判定すれば、フランス語のユーザーがShiftを押す必要はありません。

Shift+2がどこでも「@」とは限らない

Shift + 数字で入力される記号は配列によって違います。Shift + 2は、US配列では「@」、イギリスとドイツの配列(日本のJIS配列も)では"です。Shift + 3は、US配列では「#」、イギリスの配列では「£」、ドイツの配列では「§」です。記号を拾うには、Digit2とevent.shiftKeyではなく、event.key === '@'を確かめてください。keyCode 50とShiftを「@」に変える古いコードは、こうしたユーザーには違う文字を入力してしまいます。

テンキーは別のコードを送る

テンキーの数字には専用のcode(Numpad1)とkeyCode(97)がありますが、Num Lockがオンならevent.keyは同じ「1」です。Num Lockがオフだと、代わりに「End」を送ります。テンキーのないノートパソコンも多いので、テンキーを必須にしないでください。event.keyを確かめれば、どちらの列でも動きます。

入力欄に数字を打つとショートカットが動く

1〜9のような1キーのショートカットは、ユーザーが入力欄に文字を打っている間にも動いてしまいます。テキスト欄に向けたキーはスキップしてください。

if (event.target.closest('input, textarea, select, [contenteditable]')) return;