スペースキーのキーコード

スペースキーは、event.key「 」(空白1つ)、event.code「Space」、keyCode 32を送ります。

すべての値の一覧

スペースの値
キーevent.codeevent.keykeyCodeevent.location
スペースSpace" "320(標準)

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 === ' ') {
    // ここに処理を書きます
  }
});
キーの位置で判定:event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Space') {
    // ここに処理を書きます
  }
});
keyCodeを使う古いコード(非推奨)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 32) {
    // ここに処理を書きます
  }
});

どの値を使うか

event.key === ' 'を確かめます。空白が1つだけ入った文字列です。event.key === 'Space'がtrueになることはありません。keyにはキーで入力される文字が入り、スペースキーで入力されるのは空白だからです。

event.code === 'Space'は、キーそのものの名前です。キーの位置が大事なゲームやショートカットに使います。どの配列でも同じです。

keyCodeはどのブラウザでも32で、空白文字の文字コードと同じですが、非推奨です。Internet ExplorerとFirefox 36以前は、keyに"Spacebar"を送っていました。これを受け付けるのは、それらのブラウザにまだ対応する場合だけにしてください。

よくあるつまずき

スペースを押すとページがスクロールする

フォーカスのある要素がスペースを使わないとき、スペースで1画面下に、Shift + スペースで1画面上にスクロールします。スクロールが始まるkeydownで止めてください。テキスト欄では止めないでください。止めると、誰も空白を入力できなくなります。

if (event.code === 'Space' && !event.target.closest('input, textarea, [contenteditable]')) {
  event.preventDefault();
}

フォーカスが残ったボタンがスペースで押される

ボタンをクリックすると、そのボタンにフォーカスが残り、スペースでもう一度押されます。スペースでジャンプするゲームなら、同時にリスタートや一時停止も起きてしまいます。フォーカスを外す(button.blur())か、ゲーム中はスペースでpreventDefault()を呼んでください。

ボタンがkeydownではなくkeyupで動く

ボタンは、Enterには押した瞬間に反応しますが、スペースには離したときにだけ反応します。スペースを押したままにしても、クリックはくり返されません。自分で作ったrole="button"の要素でキーを処理するなら、同じようにします。Enterはkeydownで、スペースはkeyupです。

日本語や中国語の入力中、スペースで変換される

IME(日本語入力など)では、スペースで入力した読みを漢字などに変換します。ハンドラーには、isComposingがtrue、またはkeyCode 229のイベントとして届きます。これらはスキップしてください。

if (event.isComposing || event.keyCode === 229) return;

ハンドラーでkeyは「 」なのに、何も表示されない

これは正常です。値は本当に空白1つなので、表示すると空に見えます。JSON.stringify(event.key)をログに出すと、" "と確かめられます。

スマホでのスペース

Androidのキーボードは、ほとんどのキーと同じように、スペースキーでもkeyCode 229とkey"Unidentified"を送ることがよくあります。入力欄で入力された空白に反応するには、代わりにinputイベントのevent.data === ' 'を読んでください。