ホーム>React>React Hook Formの使い方:register・handleSubmit・watchとエラー表示(v7.92で確かめた)
React

React Hook Formの使い方:register・handleSubmit・watchとエラー表示(v7.92で確かめた)

いつもご利用ありがとうございます。
この記事にはアフィリエイト広告を含む広告が掲載されており、その広告費によって運営しています。
Amazonのアソシエイトとして、ララテックは適格販売により収入を得ています。

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.js22.23.5(Docker の node:22)
React / React DOM19.3.1
react-hook-form7.92.0
Vite8.3.8
Vitest5.1.0
@testing-library/react16.3.3
@testing-library/user-event14.6.12
jsdom31.0.1

画面の確認は Chromium 156 で行いました。

React のプロジェクトの作り方は Vite+Reactの環境構築 に書いています。

インストール

npm install react-hook-form

7.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= email

name・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 に渡した関数に届きました。

ビルドしてブラウザで開くと、こうなります。

会員登録のフォームに山田・yamada@example.com・20・有料を入力して送信し、下に送信されたデータのJSONが表示された画面

プランで「有料」を選んだときだけ「有料プランは月末に請求されます」が出ているのは、後で説明する 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入門チュートリアル にまとめています。

フィードバックのお願い
この記事のフィードバックがありましたらYoutubeの適当な動画にコメントしていただいたり、お問い合わせからご連絡ください。