Enterキーのキーコード
Enterはevent.key「Enter」とkeyCode 13を送ります。2つのEnterキーは同じ値で、event.codeとevent.locationで見分けます。
すべての値の一覧
| キー | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Enter / return | Enter | Enter | 13 | 0(標準) |
| テンキーのEnter | NumpadEnter | Enter | 13 | 3(テンキー) |
keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。
ここで押してみる
ここをクリックしてから、Enterを押してください
キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。
Enterに反応するコード
document.addEventListener('keydown', (event) => {
if (event.key === 'Enter') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Enter') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 13) {
// ここに処理を書きます
}
});どの値を使うか
event.key === 'Enter'を確かめます。メインのEnterキーでもテンキーのEnterでも、どの配列でも同じ値です。本物のEnterを送るスマホのキーボードでも同じです。
event.codeは、2つのキーで別の動作をさせたいときだけ使います。Enterが大きなキー、NumpadEnterがテンキーのキーです。Macのreturnキーも同じキーで、やはりEnterを送ります。
keyCode 13はどのブラウザでもまだ届くので、古いコードも動きますが、非推奨です。
よくあるつまずき
日本語・中国語・韓国語の入力中にEnterでメッセージが送信される
IME(日本語入力など)を使っているとき、Enterはまず変換中の文字を確定します。keydownハンドラーにもそのEnterが届きます。変換中はスキップしてください。
if (event.isComposing || event.keyCode === 229) return;
両方を確かめます。Safariは確定のEnterを、isComposingがfalseでkeyCodeが229のまま送るからです。
テキスト欄でEnterを押すとフォームが送信される
これはブラウザの暗黙の送信です。Enterで別のことをさせたいなら、keydownハンドラーでevent.preventDefault()を呼びます。または、キーではなくフォームのsubmitイベントを受け取ります。こうすると、スマホのキーボードの「開く」ボタンなども拾えます。
ハンドラーが2回、または何度も動く
Enterを押したままにすると、keydownがくり返し発生します。メッセージの送信など、1回だけ起きてほしい動作をEnterで始めるなら、if (event.repeat) return;でくり返しを無視してください。
keypressやkeyupがkeydownと同じように動かない
keypressは非推奨で、文字を入力するキーでしか発生しません。Enterではまだ発生しますが、これに頼らないでください。keyupは、ブラウザがフォームを送信したり改行を入れたりしたあとに届くので、止めるには遅すぎます。keydownを使ってください。
スマホのEnterに「開く」「次へ」「送信」と表示される
ラベルは自分で選べます。入力欄にenterkeyhint="send"(またはgo、next、search、done)を付けます。AndroidのキーボードはほとんどのキーをkeyCode 229として送りますが、Enterはたいてい本物のEnterとkeyCode 13で届きます。
Shift+EnterとCtrl+Enter
チャット欄では、ふつうEnterで送信し、Shift + Enterで改行します。event.shiftKeyを確かめてください。Ctrl + Enter(MacではCmd + Enter)は、「そのまま送信」によく使われるショートカットです。event.ctrlKey || event.metaKeyを確かめます。<textarea>では、preventDefault()を呼ばない限り、Enterで改行が入ります。