React Hook Formの使い方:register・handleSubmit・watchとエラー表示(v7.92で確かめた)
目次
React Hook Formの使い方を、register・handleSubmit・watchの順に解説します。registerが返すもの、バリデーションとエラーメッセージの表示、数値の入力が文字列になる件(valueAsNumber)、エラーが出るタイミング(mode)、watch・useWatch・getValuesで再描画の回数がどう変わるか、resetまで、React Hook Form 7.92とReact 19.3のテスト結果つきで書いています。
React でフォームを作ると、入力欄ごとに useState と onChange を書くことになって、欄が増えるほどコードが長くなります。
React Hook Form は、その手間を register という関数1つにまとめてくれるライブラリです。
この記事では、register・handleSubmit・watch の3つを中心に、実際にテストを書いて動きを確かめながら使い方をまとめます。
この記事のコードは、2026年11月に Docker の node:22 のコンテナで、Vite で作った React のプロジェクトに入れて確かめたものです。
確かめた環境
| もの | バージョン |
|---|---|
| Node.js | 22.23.5(Docker の node:22) |
| React / React DOM | 19.3.1 |
| react-hook-form | 7.92.0 |
| Vite | 8.3.8 |
| Vitest | 5.1.0 |
| @testing-library/react | 16.3.3 |
| @testing-library/user-event | 14.6.12 |
| jsdom | 31.0.1 |
画面の確認は Chromium 156 で行いました。
React のプロジェクトの作り方は Vite+Reactの環境構築 に書いています。
インストール
npm install react-hook-form7.92.0 が入りました。
依存しているパッケージはなく、これだけで使えます。
最初のフォーム:register と handleSubmit
名前・メールアドレス・年齢・プランの4つを持つ、会員登録のフォームを作りました。
// src/SignupForm.jsx
import { useForm } from "react-hook-form"
export default function SignupForm({ onSave = (data) => console.log(data) }) {
const {
register,
handleSubmit,
watch,
formState: { errors },
} = useForm({
defaultValues: { name: "", email: "", age: "", plan: "free" },
})
const plan = watch("plan")
const onSubmit = (data) => {
onSave(data)
}
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="name">名前</label>
<input id="name" {...register("name", { required: "名前を入力してください" })} />
{errors.name && <p role="alert">{errors.name.message}</p>}
</div>
<div>
<label htmlFor="email">メールアドレス</label>
<input
id="email"
type="email"
{...register("email", {
required: "メールアドレスを入力してください",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "メールアドレスの形式が正しくありません",
},
})}
/>
{errors.email && <p role="alert">{errors.email.message}</p>}
</div>
<div>
<label htmlFor="age">年齢</label>
<input
id="age"
type="number"
{...register("age", {
valueAsNumber: true,
min: { value: 18, message: "18歳以上で登録できます" },
})}
/>
{errors.age && <p role="alert">{errors.age.message}</p>}
</div>
<div>
<label htmlFor="plan">プラン</label>
<select id="plan" {...register("plan")}>
<option value="free">無料</option>
<option value="pro">有料</option>
</select>
{plan === "pro" && <p>有料プランは月末に請求されます</p>}
</div>
<button type="submit">登録する</button>
</form>
)
}useState が1つもないのがポイントです。
noValidate は、ブラウザの標準のチェック(type="email" の吹き出しなど)を止めて、React Hook Form のエラー表示にそろえるために付けています。
register が返すもの
{...register("name")} と、スプレッドで input に渡しているのが不思議に見えるかもしれません。
register("email") が何を返しているかを、テストの中で表示しました。
register("email") = [ 'name', 'onChange', 'onBlur', 'ref' ] name= emailname・onChange・onBlur・ref の4つが入ったオブジェクトでした。
これを input に展開することで、React Hook Form が ref で入力欄を直接つかみ、値の変化と、欄から離れたことを受け取れるようになります。
v6 までは ref={register} と書いていたので、古い記事のコードを写すときは注意です。
入力して送信すると data に値がまとまる
Vitest と Testing Library で、4つの欄に入力して送信しました。
await user.type(screen.getByLabelText("名前"), "山田")
await user.type(screen.getByLabelText("メールアドレス"), "[email protected]")
await user.type(screen.getByLabelText("年齢"), "20")
await user.selectOptions(screen.getByLabelText("プラン"), "pro")
await user.click(screen.getByRole("button", { name: "登録する" }))送信された data: {"name":"山田","email":"[email protected]","age":20,"plan":"pro"}register に付けた名前がそのままキーになって、handleSubmit に渡した関数に届きました。
ビルドしてブラウザで開くと、こうなります。
プランで「有料」を選んだときだけ「有料プランは月末に請求されます」が出ているのは、後で説明する watch の働きです。
バリデーションとエラーメッセージ
register の2つ目の引数に、ルールとメッセージを書きます。
| ルール | 意味 |
|---|---|
| required | 必須 |
| minLength / maxLength | 文字数の下限・上限 |
| min / max | 数値の下限・上限 |
| pattern | 正規表現 |
| validate | 自分で書いた関数 |
{ value: 18, message: "..." } の形で書くと、エラーになったときに errors.age.message にそのメッセージが入ります。
空のまま送信すると onSubmit は呼ばれない
何も入力せずに「登録する」を押しました。
空で送信したときのエラー: [ '名前を入力してください', 'メールアドレスを入力してください' ]
onSave の呼び出し回数: 0エラーがあると、handleSubmit に渡した関数は呼ばれませんでした。
送信の処理の中で、もう一度入力をチェックする必要はないということですね!
ブラウザで試すと、最初のエラーの欄(名前)にカーソルが移っていました。
公式ドキュメントによると、これは shouldFocusError という設定で、既定で true になっているとのことです(useForm | React Hook Form)。
数値の入力は valueAsNumber がないと文字列
type="number" の欄でも、何も指定しないと値は文字列で届きます。
valueAsNumber なし: {"age":"20"} string上の会員登録のフォームのように register("age", { valueAsNumber: true }) にすると、"age":20 と数値になっていました。
ただし、年齢を空のまま送信すると、こうなりました。
年齢が空のときの data: { name: '山田', email: '[email protected]', age: NaN, plan: 'free' } age は number空欄は NaN になり、min: 18 のエラーにもなりませんでした。
年齢を必須にしたいなら required も付ける必要があります。
17 を入れたときは、ちゃんと [ '18歳以上で登録できます' ] のエラーが出ました。
エラーが出るタイミング(mode)
入力中にエラーが出ないけど、これって壊れてる?と戸惑うことがあります。
既定の動きを確かめました。
送信前に abc と入力して離れた: []
送信後: [ '名前を入力してください', 'メールアドレスの形式が正しくありません' ]
[email protected] まで入力: [ '名前を入力してください' ]1回目の送信まではエラーが出ず、送信した後は、入力するたびにチェックされてエラーが消えました。
これは useForm の mode が既定で onSubmit、送信後の reValidateMode が既定で onChange だからです。
入力欄から離れたときにエラーを出したいなら、mode: "onBlur" にします。
const { register, formState: { errors } } = useForm({ mode: "onBlur" })フォーカスしただけ: []
mode: 'onBlur' で離れた: [ '必須です' ]公式ドキュメントによると、ほかに onChange(入力のたびに検証。再描画が増える)・onTouched(最初に離れたときから、その後は入力のたびに)・all があるとのことです(useForm | React Hook Form)。
watch で入力中の値を使う
プランで「有料」を選んだときだけ注意書きを出すのに、watch("plan") を使いました。
const plan = watch("plan")
// ...
{plan === "pro" && <p>有料プランは月末に請求されます</p>}テストでも、pro を選ぶと注意書きが出ることを確かめています。
便利な watch ですが、使うと再描画が増えます。
React Hook Form は「入力しても再描画しない」のが売りなので、どれくらい変わるかを数えてみました(・ω・)
watch・useWatch・getValues の再描画の回数
コンポーネントの中でカウンターを増やし、入力欄に abcde と5文字入力する間に何回描画されたかを数えました。
// watch を使わない
function Plain() {
counts.plain++
const { register } = useForm()
return <input {...register("title")} />
}
// watch() ですべての値を見る
function WatchAll() {
counts.watchAll++
const { register, watch } = useForm()
const values = watch()
// ...
}
// watch("title") で1つの欄だけを見る(memo 欄もある)
function WatchOne() {
counts.watchOne++
const { register, watch } = useForm()
const title = watch("title")
// ...
}
// useWatch を子コンポーネントに置く
function Preview({ control }) {
counts.useWatchChild++
const title = useWatch({ control, name: "title" })
return <p>{title}</p>
}plain: 入力中の再描画 0 回
watchAll: 入力中の再描画 5 回
watchOne: 入力中の再描画 5 回
watch('title') のとき memo 欄に入力: 再描画 0 回
useWatch: 親 0 回 / 子 5 回、表示=abcde
getValues: [ 'abcde', 2 ] (値, それまでの描画回数)watch を使わなければ、5文字入力しても再描画は0回でした!
watch() や watch("title") を使うと、1文字ごとにフォーム全体が描画し直されて5回です。
watch("title") のときに、別の memo 欄に入力したときは0回で、見ている欄以外の入力では再描画されませんでした。
useWatch を子コンポーネントに置くと、親(フォーム)は0回のままで、子だけが5回描画されました。
getValues は、ボタンを押したときに値を読むだけで、入力の前も後も描画回数は2回(最初の表示の分)のままでした。
| 使い方 | 向いている場面 |
|---|---|
| watch | 小さなフォームで、入力に合わせて表示を変えたいとき |
| useWatch | 大きなフォームで、表示を変える部分だけを子に分けたいとき |
| getValues | 送信やボタンを押したときに、その時点の値を読むだけのとき |
フォームが小さいうちは watch で十分ですが、欄が多くて重いと感じたら useWatch に分けるのがよさそうです。
reset で初期値に戻す
useForm の defaultValues に初期値を入れておくと、reset() で戻せます。
const { register, reset } = useForm({ defaultValues: { name: "初期値" } })入力後: 変更後
reset(): 初期値
reset({ name: 'APIから取得した値' }): APIから取得した値reset() で defaultValues に戻り、値を渡すとその値になりました。
API から取ってきたデータを編集フォームに入れるときは、reset(取得したデータ) が使えます。
公式ドキュメントによると、defaultValues は最初の値がキャッシュされるので、後から変えたいときは reset を使うとのことです(useForm | React Hook Form)。
参考:外部の部品やスキーマで検証したいとき
MUI の入力部品のように、ref を受け取れない部品は register ではつなげず、Controller を使うようです(Controller | React Hook Form)。
また、Zod などのスキーマでまとめて検証したいときは、@hookform/resolvers の zodResolver を useForm({ resolver: zodResolver(schema) }) に渡す方法があるとのことです(@hookform/resolvers)。
まとめ
React Hook Form は、register を input に展開するだけで値とエラーをまとめて扱えるので、useState だらけのフォームよりずっと短く書けました。
- 送信は
handleSubmit(関数)。エラーがあると関数は呼ばれない - 数値は
valueAsNumber: true。空欄はNaNになるのでrequiredと組み合わせる - エラーは既定では送信してから出る。早く出したいなら
mode: "onBlur" - 入力中の値は
watch。再描画が気になったらuseWatchかgetValues
フォームの作り方で迷ったら、まずは register と handleSubmit の2つだけで書いてみてください(^^)
React の基本は Reactとは? と React入門チュートリアル にまとめています。




