Reactのreact-hook-formで、入力欄を増やしたり減らしたりする方法
react-hook-form の useFieldArray を使うと、「追加」ボタンで入力欄の行を増やし、「削除」ボタンで減らすフォームを作れます。入力した値は、送信するときに配列として受け取れます。イベントの参加者の登録のように、入力する人数や項目の数が決まっていない動的なフォームに使えます。
私は、参加者の名前とメールアドレスを入れる行を増やしたり減らしたりするフォームを作り、行の数のバリデーションや key の付け方による違いを、検証環境で確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Chromium 153 です。使ったのは react / react-dom 19.3.1、react-hook-form 7.91.0、typescript 7.0.2、vite 8.3.7 です。tsc で型チェックしてから Vite の開発サーバーで動かし、Playwright で Chromium を操作しました。
2026年11月10日の時点で、react-hook-form の 8.0.0 はベータ版です。v8 での動き、zod などの resolver と組み合わせたとき、行の中にさらに配列を持つ入れ子の形、insert・move・swap での並べ替えは試していません。
フォームの値の型に、オブジェクトの配列を持たせる
まず、フォームの値の型を決めます。参加者1人ぶんの { name, email } を並べた配列を、members という名前で持たせました。
useFieldArray に渡す配列は、文字列や数値の配列ではなく、オブジェクトの配列にします。公式リファレンスの決まりごとの節(Rules)に、['a', 'b'] のような配列には対応していないと書かれています。名前だけを入れるフォームでも、{ name: string }[] のように1つずつオブジェクトで包みます。
useFieldArray の fields から、行ごとに入力欄を出す
次のコードは MembersForm.tsx です。参加者は1人ぶんの空の行から始まり、3人まで追加できます。送信に成功したら、受け取ったデータを画面に出しています。
import { useState } from 'react';
import { useForm, useFieldArray } from 'react-hook-form';
type FormValues = {
members: { name: string; email: string }[];
};
const MAX_MEMBERS = 3;
export function MembersForm() {
const [sent, setSent] = useState<FormValues | null>(null);
const {
register,
control,
handleSubmit,
formState: { errors },
} = useForm<FormValues>({
defaultValues: { members: [{ name: '', email: '' }] },
});
const { fields, append, remove } = useFieldArray({
control,
name: 'members',
rules: {
required: '参加者を1人以上追加してください',
maxLength: { value: MAX_MEMBERS, message: `参加者は${MAX_MEMBERS}人までです` },
},
});
return (
<form onSubmit={handleSubmit((data) => setSent(data))} noValidate>
{fields.map((field, index) => (
<fieldset key={field.id}>
<legend>参加者 {index + 1}</legend>
<label>
名前
<input {...register(`members.${index}.name`, { required: '名前を入力してください' })} />
</label>
{errors.members?.[index]?.name && (
<p className="error">{errors.members[index].name.message}</p>
)}
<label>
メール
<input type="email" {...register(`members.${index}.email`)} />
</label>
<button type="button" onClick={() => remove(index)}>
削除
</button>
</fieldset>
))}
{errors.members?.root && <p className="error">{errors.members.root.message}</p>}
<button type="button" onClick={() => append({ name: '', email: '' })}>
参加者を追加
</button>
<button type="submit">送信</button>
{sent && <pre>{JSON.stringify(sent, null, 2)}</pre>}
</form>
);
}
useFieldArray には、useForm から受け取った control と、配列の名前 members を渡します。返ってくる fields を map して、1行ぶんの入力欄を出します。
行の中の入力欄は、register に members.${index}.name のような名前を渡して登録します。index は map の2つ目の引数で、何行目かを表す番号です。React の key には、index ではなく field.id を渡します。field.id は useFieldArray が行ごとに作る値です(理由は後の節で、画面の違いを見せて説明します)。
行を増やすのは append、減らすのは remove です。append には、行の入力欄すべての初期値をそろえたオブジェクトを渡します。remove には、消したい行の番号を渡します。公式リファレンスの戻り値(Return)の表には、remove に番号を渡さないと全部の行を消すと書かれています。
「追加」と「削除」のボタンには type="button" を付けます。MDN の button 要素のページにあるとおり、form の中のボタンは type を書かないと送信ボタンになるためです。
検証環境(Chromium 153)で操作した様子です。「参加者を追加」を2回押して3行にし、2行目の「削除」を押しました。

2行目を消すと、3行目にあった「高橋」の行が繰り上がり、見出しも「参加者 2」になりました。入力欄の name も members.1.name に付け直されています。この状態で送信すると、handleSubmit に渡した関数は、画面の並びどおりの配列を受け取りました。
{
"members": [
{
"name": "佐藤",
"email": ""
},
{
"name": "高橋",
"email": ""
}
]
}
append で行を足すと、新しい行の最初の入力欄(名前の欄)にフォーカスが移りました。1回目は members.1.name、2回目は members.2.name です。同じ表によると、append の2つ目の引数に { shouldFocus: false } を渡すと、フォーカスを移さないようにできます。
行の数のバリデーションは、0行なら required、上限は maxLength
useFieldArray の rules には、register と同じ書き方で required、minLength、maxLength、validate を書けます。行の数が合わないときのメッセージは、配列そのもののエラーとして errors.members.root に入ります。上のコードでは、「参加者を追加」ボタンの上に出しています。
検証環境で行を4つに増やして送信すると、「参加者は3人までです」が出て、送信の処理は呼ばれませんでした。1行削除するとメッセージは消え、もう一度送信すると送れました。
「1人以上」を確かめるため、rules に minLength: { value: 1, … } だけを書いた場合と、required を書いた場合を比べました。minLength だけの場合は、行を全部削除して送信すると、エラーは出ずに { "members": [] } がそのまま送信されました。required の場合は、「参加者を1人以上追加してください」が出て止まりました。
react-hook-form 7.91.0 のソースを読むと、minLength と maxLength は、値が空でないときだけ調べる作りでした。配列は長さが0だと空として扱われるので、minLength は調べられません。空の配列を止めるのは required の役目です。
0行での送信を止めたいときは、rules に required を書きます。minLength は、1行以上あるときに「2行以上」のような下限を調べるのに使います。
なお、公式リファレンスの引数(Props)の表には、rules は react-hook-form の組み込みのバリデーションでだけ使えると書かれています。
key に index を渡すと、行の中の state が別の行に残る
React の公式ドキュメントの、key でリストの順序を保つ節には、インデックスを key にすると、項目を挿入・削除・並べ替えたときに分かりにくいバグの原因になると書かれています。react-hook-form の公式リファレンスも、key には index ではなく field.id を渡すように書いています。
これを確かめるため、1行を MemberRow というコンポーネントに分け、行の中に useState で「メモを開いているか」を持たせました。「メモ」ボタンを押すと、行の右に「メモを表示中」と出ます。このデモでは、フォームの値の型を { members: { name: string }[] } にし、親のコンポーネントの fields.map で、MemberRow に渡す key を index と field.id で切り替えました。
function MemberRow({
index,
register,
onRemove,
}: {
index: number;
register: UseFormRegister<FormValues>;
onRemove: () => void;
}) {
// 行の中だけで持つ状態(メモ欄を開いているか)
const [showNote, setShowNote] = useState(false);
return (
<div className="row">
<input {...register(`members.${index}.name`)} />
<button type="button" onClick={() => setShowNote((v) => !v)}>
メモ
</button>
<button type="button" onClick={onRemove}>
削除
</button>
{showNote && <span className="note">メモを表示中</span>}
</div>
);
}
佐藤・鈴木・高橋の3行で、1行目の名前を「佐藤花子」に書き換え、1行目のメモを開いてから1行目を削除しました。key={index} と key={field.id} で、削除したあとの画面を比べたのが次の画像です。

key={index} では、消したはずの「佐藤花子」の行で開いていたメモが、繰り上がった「鈴木」の行に出たままになりました。React は key が同じコンポーネントを同じものとして扱うので、削除したあとも key が0のコンポーネントは残り、その中の state も残りました(React の公式ドキュメントの、key で state をリセットする節)。key={field.id} では、佐藤花子の行のコンポーネントごと消え、鈴木の行のメモは閉じたままでした。
一方、入力欄に表示された名前と、フォームの値(useWatch で読んだもの)は、どちらの key でも「鈴木、高橋」で、ずれませんでした。ずれたのは、行のコンポーネントの中に持たせた state だけでした。行の中に state を持たせる場合は、key に field.id を渡すと、削除した行の state が別の行に残りません。
型の付け方を間違えると、tsc で止まる
useForm<FormValues> で型を付けておくと、useFieldArray の使い方の間違いの一部は、型チェックで分かります。検証環境で次の2つを tsc にかけました。
1つ目は、文字列の配列 tags: string[] を useFieldArray の name に渡したものです。2つ目は、{ name, email } の配列に、append({ name: '' }) のように email のないオブジェクトを足そうとしたものです。
typetest/partial.tsx(8,54): error TS2345: Argument of type '{ name: string; }' is not assignable to parameter of type '{ name: string; email: string; }[] | { name: string; email: string; }'.
Property 'email' is missing in type '{ name: string; }' but required in type '{ name: string; email: string; }'.
typetest/primitive.tsx(7,47): error TS2322: Type 'string' is not assignable to type 'never'.
どちらも、公式リファレンスの決まりごとの節(Rules)にある「オブジェクトの配列にする」「append には入力欄すべての値を渡す」という決まりに当たるものです。文字列の配列のほうは「never に代入できない」というメッセージで、オブジェクトの配列にする必要があることまでは書かれていません。useFieldArray の name でこのエラーが出たら、配列の中身がオブジェクトになっているかを見直してください。





