スペースキーのキーコード
スペースキーは、event.key「 」(空白1つ)、event.code「Space」、keyCode 32を送ります。
すべての値の一覧
| キー | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| スペース | Space | " " | 32 | 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 === ' ') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Space') {
// ここに処理を書きます
}
});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 === ' 'を読んでください。