Enterキーのキーコード

Enterはevent.key「Enter」とkeyCode 13を送ります。2つのEnterキーは同じ値で、event.codeとevent.locationで見分けます。

すべての値の一覧

Enterの値
キーevent.codeevent.keykeyCodeevent.location
Enter / returnEnterEnter130(標準)
テンキーのEnterNumpadEnterEnter133(テンキー)

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

ここで押してみる

ここをクリックしてから、Enterを押してください

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

Enterに反応するコード

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