ReactでEnterキーを押すと次の入力欄へ移るフォームを作る方法
React のフォームで Enter キーを押したときに、送信せずに次の入力欄へ移すには、<form> の onKeyDown で Enter を受け取り、e.preventDefault() で送信を止めてから、次の欄の focus() を呼びます。会員登録や伝票入力の画面で「Enterキーで次の項目へ進みたい」「途中で Enter を押したら、まだ書きかけなのに送信されてしまう」というときに使える書き方です。日本語入力で変換を確定する Enter まで次の欄へ進まないように、isComposing で見分けるところまで書きます。
検証環境は Ubuntu 24.04、Node.js 22.23.4 です。使ったのは react / react-dom 19.3.1、@types/react / @types/react-dom 19.3.0、typescript 7.0.2、esbuild 0.28.2、Playwright 1.63.0 と、それに付属の Chromium 153 です。.tsx を tsc で型チェックしてから esbuild で変換し、Chromium の上で Playwright から実際にキーを押して確かめました。日本語入力の変換中の Enter は、本物の IME ではなく、Chrome DevTools Protocol(CDP)の Input.imeSetComposition で変換中の状態を作って送ったものです。Firefox・Safari、スマートフォンのソフトウェアキーボード、フォームのライブラリと組み合わせる書き方は試していません。

何もしないと、最初の欄で Enter を押しただけで送信される
比べるために、Enter に何もしていないフォームを作りました。送信されると、送られた値を下に出します。
import { useState, type FormEvent } from 'react';
export function PlainForm() {
const [sent, setSent] = useState('まだ送信していません');
function handleSubmit(e: FormEvent<HTMLFormElement>) {
e.preventDefault();
const data = Object.fromEntries(new FormData(e.currentTarget));
setSent(`送信しました:${JSON.stringify(data)}`);
}
return (
<form onSubmit={handleSubmit}>
<label>お名前 <input name="name" /></label>
<label>メール <input name="email" type="email" /></label>
<label>電話番号 <input name="tel" type="tel" /></label>
<button type="submit">登録する</button>
<output>{sent}</output>
</form>
);
}
お名前の欄に「山田」と打って Enter を押すと、メールと電話番号が空のまま送信されました。
お名前に「山田」と打って Enter → フォーカス: plain の input[name=name]
output: 送信しました:{"name":"山田","email":"","tel":""}
これはブラウザの決まった動きです。HTML の仕様の「暗黙の送信(implicit submission)」には、一部のプラットフォームでの例として、送信ボタンのあるフォームでは、テキストの入力欄にフォーカスがあるときに Enter を押すとフォームが送信される、と書かれています。次の欄へ移したいなら、この送信を止める必要があります。
formのonKeyDownで、次の欄へフォーカスを移す
Enter の処理は、入力欄ごとに書かずに、<form> の onKeyDown に1つだけ付けます。React の公式ドキュメントにあるイベントの伝播(propagation)のとおり、キーを押したときのイベントは入力欄から <form> まで伝わってくるので、e.target で押された欄が、e.currentTarget でフォームが分かります。
import type { KeyboardEvent } from 'react';
type Field = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
const BUTTON_TYPES = ['submit', 'button', 'reset', 'image'];
// Enter で移る先の欄を、フォームの中の並び順で集める(ボタン・hidden・無効な欄は除く)
function fieldsOf(form: HTMLFormElement): Field[] {
return Array.from(form.elements).filter((el): el is Field => {
if (el instanceof HTMLInputElement) {
return el.type !== 'hidden' && !BUTTON_TYPES.includes(el.type) && !el.disabled;
}
if (el instanceof HTMLSelectElement || el instanceof HTMLTextAreaElement) return !el.disabled;
return false;
});
}
export function moveFocusOnEnter(e: KeyboardEvent<HTMLFormElement>) {
if (e.key !== 'Enter') return;
// 日本語入力で、変換を確定するための Enter は何もしない
if (e.nativeEvent.isComposing || e.keyCode === 229) return;
const target = e.target;
// textarea の改行と、ボタンを押す Enter は、ふだんどおりにする
if (!(target instanceof HTMLInputElement || target instanceof HTMLSelectElement)) return;
const fields = fieldsOf(e.currentTarget);
const index = fields.indexOf(target);
if (index === -1) return;
e.preventDefault(); // フォームがその場で送信されるのを止める
const next = fields[index + (e.shiftKey ? -1 : 1)];
if (next) {
next.focus();
} else if (!e.shiftKey) {
e.currentTarget.requestSubmit(); // 最後の欄では送信する
}
}
次の欄を探すのに使っているのは、フォームの elements です。MDN の HTMLFormElement.elements の説明のとおり、フォームの中の入力欄やボタンが、文書に出てくる順に並んでいます。ここから入力欄だけを残して、押された欄の次を focus() します。欄ごとに useRef を用意して順番を書き並べる必要はなく、JSX に書いた順(文書の順)に移ります。elements には fieldset・ボタン・output なども入っているので、fieldsOf() で除いています。<input type="submit"> のように <input> で作ったボタンも、type を見て除いています。
e.preventDefault() は、React の公式ドキュメントにある、ブラウザのもともとの動きを止める書き方です。これで、前の節の暗黙の送信が起きなくなります。Shift を押しながら Enter を押したときは、前の欄へ戻します。
これを、会員登録のフォームの <form> に付けました。
import { useState, type FormEvent } from 'react';
import { moveFocusOnEnter } from './moveFocusOnEnter';
export function SignupForm() {
const [sent, setSent] = useState('まだ送信していません');
function handleSubmit(e: FormEvent<HTMLFormElement>) {
e.preventDefault();
const data = Object.fromEntries(new FormData(e.currentTarget));
setSent(`送信しました:${JSON.stringify(data)}`);
}
return (
<form onKeyDown={moveFocusOnEnter} onSubmit={handleSubmit}>
<label>お名前 <input name="name" required /></label>
<label>メール <input name="email" type="email" required /></label>
<label>
都道府県
<select name="pref">
<option>東京都</option>
<option>大阪府</option>
</select>
</label>
<label>電話番号 <input name="tel" type="tel" /></label>
<button type="submit">登録する</button>
<output>{sent}</output>
</form>
);
}
Chromium で、各欄に打っては Enter を押していきました。Enter のたびに次の欄へ移り、select の欄でも、Enter で次の欄へ移りました。select の値は「東京都」のままでした。最後の電話番号の欄で Enter を押したところで、はじめて送信されています。
お名前に「山田」と打って Enter → フォーカス: signup の input[name=email]
output: まだ送信していません
メールに打って Enter → フォーカス: signup の select[name=pref]
都道府県(select)で Enter → フォーカス: signup の input[name=tel]
select の値: 東京都
電話番号で Shift+Enter → フォーカス: signup の select[name=pref]
都道府県で Enter → フォーカス: signup の input[name=tel]
電話番号(最後の欄)で Enter → フォーカス: signup の input[name=tel]
output: 送信しました:{"name":"山田","email":"tama@example.com","pref":"東京都","tel":"090-0000-0000"}
最後の欄ではrequestSubmitで送信する
最後の欄で submit() ではなく requestSubmit() を呼んでいるのは、入力のチェックを通すためです。MDN の requestSubmit() の説明によると、requestSubmit() は送信ボタンを押したときと同じように働き、フォームの内容を検証して、問題がないときだけ送信します。submit() は検証をせずに送信します。
お名前を空にしてから、電話番号の欄で Enter を押してみました。required を付けたお名前の欄でエラーになり、フォーカスがお名前の欄へ移って、送信はされませんでした(下の表示は、前に送信したときのままです)。
電話番号で Enter → フォーカス: signup の input[name=name]
お名前の validationMessage: Please fill out this field.
output: 送信しました:{"name":"山田","email":"tama@example.com","pref":"東京都","tel":"090-0000-0000"}(前の送信のまま)
日本語入力の変換を確定するEnterでは移らない
日本語を入力するときの Enter は、変換を確定するためにも押します。何もしないと、変換を確定するつもりで押した Enter で、フォーカスまで次の欄へ移ってしまいます。
isComposing を見ないで次の欄へ移すだけのハンドラーで確かめました。お名前の欄で「やまだ」を変換している途中に Enter を送ると、「やまだ」とひらがなのまま確定して、フォーカスはメールの欄へ移りました。
import type { KeyboardEvent } from 'react';
// 比べるための、isComposing を見ずに次の欄へ移るハンドラー
export function moveWithoutComposingCheck(e: KeyboardEvent<HTMLFormElement>) {
if (e.key !== 'Enter' || !(e.target instanceof HTMLInputElement)) return;
const fields = Array.from(e.currentTarget.querySelectorAll('input'));
const next = fields[fields.indexOf(e.target) + 1];
e.preventDefault();
next?.focus();
}
[isComposing を見ないハンドラー]
変換中に Enter → フォーカス: nocheck の input[name=email] / お名前の値: やまだ
イベント: keydown key=Enter isComposing=true keyCode=13 / compositionend data=やまだ
MDN の KeyboardEvent.isComposing の説明のとおり、isComposing は、変換の途中(compositionstart から compositionend までの間)に起きたキーのイベントで true になります。上の出力でも、変換中の Enter は isComposing=true でした。React の公式リファレンスの、イベントオブジェクトの説明にあるとおり、ブラウザのもとのイベントは nativeEvent に入っています。キーボードイベントの項目の一覧に isComposing はありません。そこで、e.nativeEvent から読みます。
moveFocusOnEnter で同じことをすると、変換中の Enter ではフォーカスが動きませんでした。変換を「山田」で確定したあと、もう一度 Enter を押したときに、メールの欄へ移っています。
[moveFocusOnEnter]
変換中に Enter → フォーカス: signup の input[name=name] / お名前の値: やまだ
「山田」で確定 → お名前の値: 山田
確定後に Enter → フォーカス: signup の input[name=email]
イベント: keydown key=Enter isComposing=true keyCode=13 / compositionend data=山田 / keydown key=Enter isComposing=false keyCode=13
e.keyCode === 229 も見ているのは、MDN の keydown イベントの説明にある、IME で変換中のキー入力を除く書き方に合わせたためです。MDN によると、変換を終える最後のキーでは、keydown より先に compositionend が起きて isComposing が false になることがあり、そのときも keyCode は 229 になります。keyCode は非推奨ですが、MDN はこの確認のために keyCode もあわせて見ることを勧めています。CDP で keyCode が 229 の Enter を送ったときは、isComposing が false でも、フォーカスはお名前の欄のままでした。
keyCode 229 の Enter → フォーカス: signup の input[name=name] / イベント: keydown key=Enter isComposing=false keyCode=229
textareaやボタンのEnterは、ふだんどおりにする
複数行の入力欄(<textarea>)では、Enter は改行に使います。ボタンにフォーカスがあるときの Enter は、そのボタンを押す操作です。moveFocusOnEnter は、押された欄が <input> か <select> のときだけ動き、それ以外では何もせずに終わります。<input type="submit"> のボタンは fieldsOf() の一覧に入らないので、index === -1 のところで終わります。
件名・無効な受付番号・本文(textarea)・チェックボックス・メールと、<input type="submit"> の「送る」ボタンが並ぶフォームで確かめました。
import { moveFocusOnEnter } from './moveFocusOnEnter';
export function ContactForm() {
return (
<form onKeyDown={moveFocusOnEnter} onSubmit={(e) => e.preventDefault()}>
<label>件名 <input name="subject" /></label>
<label>受付番号 <input name="ticket" disabled /></label>
<label>本文 <textarea name="body" /></label>
<label><input name="copy" type="checkbox" /> 控えをメールで受け取る</label>
<label>メール <input name="email" type="email" /></label>
<input type="submit" value="送る" />
</form>
);
}
件名で Enter を押すと、disabled の受付番号を飛ばして本文へ移りました。本文の中の Enter は改行になり、フォーカスは本文に残りました。本文から先へは Tab で進みます。チェックボックスで Enter を押すと、チェックは入らずに次のメールの欄へ移りました。最後の欄のメールで Enter を押すと送信されました。「送る」ボタンにフォーカスがあるときの Enter では、ふだんどおり送信されました。
件名で Enter → フォーカス: contact の textarea[name=body]
本文に「1行目」と打って Enter → フォーカス: contact の textarea[name=body]
本文の値: "1行目\n2行目"
本文で Tab → フォーカス: contact の input[name=copy]
チェックボックスで Enter → フォーカス: contact の input[name=email]
チェックボックス checked: false
メール(最後の欄)で Enter → フォーカス: contact の input[name=email]
submit イベントの回数: 1
メールで Tab → フォーカス: contact の input
「送る」ボタン(input type=submit)で Enter → フォーカス: contact の input
submit イベントの回数: 2
Enter で次へ進むのは、Tab の代わりではなく、Tab に加えて使える操作です。Tab での移動はそのまま残っているので、キーボードで操作する人がこれまでどおりに使えます。





