フォームと制御コンポーネント — 1文字ごとに全部再描画

フォームと制御コンポーネント。入力欄のあるフォームとキーボード、再描画のマーク。

入力のたびに画面全部が描き直されます。制御コンポーネントの仕組みを押さえ、1文字ごとの再描画を抑えます。

前回: カスタムフック — 似ているだけでは共通化しない

これは深掘りです。本線の順路ではありません。 本線のコンポーネントとpropsの回で入力欄を作り、「value と onChange を書くものだと教わったから書いている」まま先へ進んでいる人が読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、すべて VM(Ubuntu Server)の中で打ちます。 Windows の PowerShell ではありません。 画面の確認は、ホストの Windows のブラウザで行います。 本線で作った ~/react-demo/ には触りません。 この記事では、まっさらな ~/reactlab/ を新しく作って、最後に丸ごと消します。

自分が実際にぶつかったところから書きます。

問い合わせフォームを作っていました。名前・メールアドレス・本文・同意チェック。React の入門どおり、入力欄はぜんぶ value と onChange で state に持たせました。 動きました。

本文の欄に長い文章を打ち始めたとき、指が重くなりました。

打った文字が、ワンテンポ遅れて出てくるのです。速く打つと、キーを離してから画面に出るまでの差がはっきり分かるくらいには遅れていました。開発マシンの上での話です。安いスマホなら、もっとひどいはずです。

最初は「Reactが遅い」と思いました。違いました。再描画の回で使った数え方をそのまま持ち込んで数えたら、答えは一発で出ました。

1文字打つ → App が呼ばれた: 1 回目
1文字打つ → App が呼ばれた: 2 回目
1文字打つ → App が呼ばれた: 3 回目

1文字ごとに、フォームだけでなく、その周りにある全部が描き直されていました。

これは React のバグではありません。value と onChange で state に持たせるというのは、「1文字ごとに state を更新する」という意味だからです。 指示どおりの動作です。

そして、入力欄の作り方には、そもそも2種類あります。 入門記事はたいてい片方(制御コンポーネント)しか書きません。もう片方を知らないと、「全部 state に持つ」以外の選択肢が無くなります。

この記事では、両方を自分の手で書いて、再描画の回数を数えて並べます。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • 入力欄の作り方は2種類あること。制御(値を React が持つ)と非制御(値を DOM が持つ)で、どちらが正解ということはない
  • 「指が重い」の原因は、制御コンポーネントそのものではなく、state を置いた場所であること。1文字ごとの再描画が、どこまで広がるかで決まる
  • value={undefined} で始めると、あとから警告が出ること(A component is changing an uncontrolled input to be controlled)。初期値は空文字にする
  • 数値入力で parseInt すると、打った 1.5 が 1 に書き戻されて、小数が打てなくなること
  • チェックボックスは value ではなく checked、選択欄(<select>)は <option selected> ではなく <select value> であること
  • 検証をどこでやるかは、3択(送信時 / 離れたとき / 入力中)であること。入力中にエラーを出すのは、たいてい嫌われる
  • ブラウザに最初から検証機能があること。required と type="email" を書くだけで、JS を1行も書かずに止まる
  • どれだけ画面側で検証しても、サーバー側の検証は必ず要ること。画面側の検証は、親切であって、防御ではない
  • 二重送信は「送信中は disabled」で止まること。ネットが遅い人ほど2回押す
  • フォームのアクセシビリティで最低限やることは3つであること(ラベルを結ぶ / エラーを結ぶ / フォーカスを移す)

この記事でやること

  1. ~/reactlab を新しく作る(本線の ~/react-demo は残したまま)。ポートは 5181
  2. 同じ内容のフォームを、制御版と非制御版の2つ書いて、再描画の回数を数えて並べる
  3. 制御コンポーネントでよくある事故を3つ、自分の画面で起こして直す(未定義の初期値 / parseInt / checked)
  4. ブラウザ標準の検証だけで止まるところまでやってから、JS の検証を足す
  5. 送信を作る(preventDefault と、二重送信の停止)
  6. ラベル・エラー・フォーカスを結んで、キーボードだけで一周できることを確かめる
  7. ~/reactlab を消して片づける

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
制御コンポーネント入力欄の値を React の state が持っている書き方。value と onChange を両方書く
非制御コンポーネント入力欄の値を DOM(ブラウザ)自身が持っている書き方。defaultValue を書き、必要になったときに読みに行く
FormDataフォームの中身をまとめて取り出すためのブラウザ標準の入れ物。new FormData(フォーム要素) で作る
バリデーション(検証)入力された値が使える形かどうかを調べること。「空でないか」「メールの形か」など
e.preventDefault()ブラウザが勝手にやろうとしている動作(フォームならページ再読み込み)をやめさせる命令
touchedその欄に一度でも触ったかを覚えておくための印。触る前にエラーを出さないために使う
aria-describedby「この入力欄の補足説明はここにある」と機械に伝える属性。エラー文と入力欄を結ぶのに使う
スキーマデータの形の決まりを書いたもの。「name は1文字以上の文字列、age は0以上の整数」のような定義

① 準備 — reactlab を新しく作る

本線で作った ~/react-demo/ は、そのまま残します。 この記事はわざと警告を出す手順を含むので、新しいプロジェクトでやります。

VMの中で打ちます。

bash
$ cd ~
$ npm create vite@latest reactlab -- --template react

質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。

bash
$ cd ~/reactlab
$ npm install
$ ls
eslint.config.js  index.html  package.json  public  README.md  src  vite.config.js

この一覧が出れば成功です。 npm install は初回だけ数分かかります。何が起きているかはnpmの回、dist/ が何なのかはビルドツールの回にあります。

ポートを開ける

本線で 5173番を使っています。 ぶつからないように、この記事は 5181番でやります。

bash
$ sudo ufw allow 5181/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere
5181/tcp                   ALLOW       Anywhere

5181/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。

起動する

bash
$ npm run dev -- --host 0.0.0.0 --port 5181

ホストの Windows のブラウザで http://192.168.226.50:5181/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。Vite のロゴとカウンターが出れば成功です。

止め方: ターミナルで Ctrl+C。この記事の間は起動したままで構いません。 保存するたびにブラウザが自動で更新されます。

[スクリーンショット: 01_reactlab起動.png] ホストのブラウザで :5181 を開き、Vite + React の初期画面が出ているところを撮ってください。アドレスバーのポート番号が 5181 になっているのが見える形で。

見た目を最低限そろえておく

この記事は入力欄をたくさん並べます。 素のままだと読みづらいので、src/index.css をまるごとこの内容にしてください。中身は本題ではありません。

body {
  font-family: sans-serif;
  margin: 0;
  padding: 24px;
  background: #fff;
  color: #222;
}
.card {
  border: 1px solid #bbb;
  border-radius: 6px;
  padding: 16px;
  margin-bottom: 16px;
  max-width: 480px;
}
label {
  display: block;
  margin-bottom: 12px;
}
input[type="text"],
input[type="email"],
input[type="number"],
textarea,
select {
  display: block;
  width: 100%;
  padding: 6px;
  font-size: 16px;
  box-sizing: border-box;
}
.error {
  color: #a00;
  font-size: 14px;
  margin: 4px 0 0;
}
.count {
  font-family: monospace;
  background: #eee;
  padding: 4px 8px;
}

② 制御と非制御 — 同じフォームを両方書いて、回数を数える

議論する前に数えます。 再描画の回で使った、関数の外に置いたカウンタをそのまま使います。

制御版

src/ControlledForm.jsx(新規)

import { useState } from "react";

let calls = 0;

export default function ControlledForm() {
  calls += 1;

  const [name, setName] = useState("");
  const [message, setMessage] = useState("");

  function handleSubmit(e) {
    e.preventDefault();
    console.log("制御版の送信:", { name, message });
  }

  return (
    <form className="card" onSubmit={handleSubmit}>
      <h2>制御版</h2>
      <p className="count">この部品が呼ばれた回数: {calls}</p>

      <label>
        名前
        <input
          type="text"
          value={name}
          onChange={(e) => setName(e.target.value)}
        />
      </label>

      <label>
        本文
        <textarea
          rows={4}
          value={message}
          onChange={(e) => setMessage(e.target.value)}
        />
      </label>

      <p>いま React が持っている名前: 「{name}」</p>
      <button type="submit">送信</button>
    </form>
  );
}

非制御版

src/UncontrolledForm.jsx(新規)

let calls = 0;

export default function UncontrolledForm() {
  calls += 1;

  function handleSubmit(e) {
    e.preventDefault();
    const data = new FormData(e.currentTarget);
    console.log("非制御版の送信:", Object.fromEntries(data));
  }

  return (
    <form className="card" onSubmit={handleSubmit}>
      <h2>非制御版</h2>
      <p className="count">この部品が呼ばれた回数: {calls}</p>

      <label>
        名前
        <input type="text" name="name" defaultValue="" />
      </label>

      <label>
        本文
        <textarea rows={4} name="message" defaultValue="" />
      </label>

      <p>React はこの欄の中身を知りません</p>
      <button type="submit">送信</button>
    </form>
  );
}

useState が1つもありません。 そしてname 属性が付いています。 これが後で効きます。

src/App.jsx(丸ごと置き換え)

import ControlledForm from "./ControlledForm.jsx";
import UncontrolledForm from "./UncontrolledForm.jsx";

export default function App() {
  return (
    <>
      <h1>制御と非制御</h1>
      <ControlledForm />
      <UncontrolledForm />
    </>
  );
}

打って、数える

ブラウザを開いて、F12 で Console を出しておいてください。

  1. 制御版の「本文」に、こんにちは と5文字打つ
  2. 非制御版の「本文」にも、こんにちは と5文字打つ

画面の「呼ばれた回数」を見比べてください。

打つ前5文字打った後
制御版212
非制御版22

打つ前が 1 ではなく 2 なのは、開発中だけ全部が2回ずつ呼ばれるからです。 これは React の StrictMode という仕組みで、バグではありません。 理由は再描画の回に書きました。ここでは「増えた分」だけを見てください。

制御版は、1文字ごとに 2 ずつ増えます。 非制御版は1つも増えません。

[スクリーンショット: 02_回数の比較.png] 両方のフォームに5文字ずつ打ったあと、「この部品が呼ばれた回数」の数字が2つとも見えている状態を撮ってください。

そして、送信ボタンを両方押して、Console を見てください。

制御版の送信: {name: '', message: 'こんにちは'}
非制御版の送信: {name: '', message: 'こんにちは'}

同じものが取れています。 非制御版は state を1つも使わず、再描画を1回もせずに、同じ結果を出しました。

非制御版は、どこから値を取ったのか

この2行です。

const data = new FormData(e.currentTarget);
console.log(Object.fromEntries(data));
  • e.currentTarget は、イベントを受け取っている要素、つまり <form> そのものです
  • new FormData(フォーム) で、そのフォームの中の入力欄を全部まとめて取り出します
  • Object.fromEntries() は、それをただの JavaScript のオブジェクトに変換します

値はどこにあったのか。DOM です。 ブラウザは、私たちが何もしなくても、入力された文字を入力欄自身が覚えています。 DOM操作の回で触った、あの DOM です。

FormData は name 属性でしか値を拾いません。 id ではありません。 name を書き忘れた欄は、エラーも警告も出ないまま、送信内容から静かに消えます。 私はこれで30分溶かしました(後述)。

では、どちらを使うのか

「制御が正解で非制御は古い」ではありません。 判断は1つの問いで決まります。

入力している最中に、何かをしたいか。

やりたいこと制御非制御
打つたびに文字数を出す(「あと120文字」)◯✕
打つたびに候補を絞り込む(検索フォーム)◯✕
入力に応じてボタンを有効/無効にする◯△(onInput を別途書けば可)
入力に応じて別の欄を出し入れする◯✕
打った内容を整形して戻す(電話番号にハイフン)◯✕
送信するときに、中身が取れればよい◯◯(こちらが素直)
欄が20個ある長いフォーム△(重くなりやすい)◯
ファイルを選ばせる(type="file")✕ できない◯(これしかない)

最後の行は、選択の余地がありません。 <input type="file"> は、セキュリティ上の理由でプログラムから値を設定できません。 ファイル入力は常に非制御です。

そして、混ぜてよいです。 現実のフォームは、「文字数を出したい本文だけ制御、あとは非制御」のような書き方をします。フォーム全体でどちらかに決めなければいけない、という決まりはありません。

「指が重い」の本当の原因

ここが誤解されるところです。

制御コンポーネントが遅いのではありません。 入力欄1つの再描画は、ふつうの機械なら1ミリ秒もかかりません。

問題は、その state をどこに置いたかです。

// ❌ フォームの state を、画面のてっぺんに置いた
export default function App() {
  const [message, setMessage] = useState("");
  return (
    <>
      <HeavyHeader />
      <HeavySidebar />
      <form>
        <textarea value={message} onChange={(e) => setMessage(e.target.value)} />
      </form>
      <HeavyTable rows={10000} />
    </>
  );
}

1文字打つたびに、HeavyTable まで呼ばれます。 再描画の回で見たとおり、state を持っている部品より下は、全部呼ばれるからです。

直し方は、useMemo を撒くことではありません。

// ◯ state を、それが要る部品の中に閉じ込める
export default function App() {
  return (
    <>
      <HeavyHeader />
      <HeavySidebar />
      <MessageForm />   {/* ← state はこの中だけ */}
      <HeavyTable rows={10000} />
    </>
  );
}

state を下に降ろすだけで、再描画は MessageForm の中で止まります。 useMemoの回で「まず置き場所を疑え」と書いたのは、まさにこの形のことです。

順番はこうです。 1. state を、それが要る一番下の部品まで降ろす 2. それでも重いなら、その欄だけ非制御にする 3. それでも重いなら、初めて計測して useMemo を考える


③ 制御コンポーネントの事故を、3つ起こす

制御コンポーネントには、初心者がほぼ全員踏む地雷が3つあります。 読んで避けるのではなく、踏みます。

事故1: value={undefined} から始めてしまう

src/ControlledForm.jsx の1行だけ変えてください。

const [name, setName] = useState();   // ← 初期値を書かなかった

保存して、ブラウザで「名前」の欄に1文字打ってください。 F12 の Console に、これが出ます。

Warning: A component is changing an uncontrolled input to be controlled.
This is likely caused by the value changing from undefined to a defined value,
which should not happen. Decide between using a controlled or uncontrolled
input element for the lifetime of the component.

日本語にすると、こうです。

非制御だった入力欄が、制御に変わりました。 value が undefined から値のあるものに変わったせいでしょう。部品が生きている間、どちらかに決めてください。

何が起きたのか。

タイミングname の中身React から見た <input>
最初の描画undefinedvalue が無い = 非制御
1文字打った後"あ"value がある = 制御

React は「value が渡されているかどうか」だけで、制御か非制御かを判断しています。 undefined を渡すのは、渡していないのと同じです。

そして、この警告は本当に困ることに繋がります。

サーバーから取ってきたデータを入れる編集フォームで、これが起きます。

// ❌ 読み込み中は user が null なので、value={undefined} になる
const [user, setUser] = useState(null);
<input value={user?.name} onChange={...} />

読み込みが終わった瞬間に、非制御から制御に切り替わります。 非同期処理の回で書いた「データが来るまでの間」が、そのままここに出てきます。

直し方は、どちらでも構いません。

const [name, setName] = useState("");        // ◯ 初期値を空文字にする
<input value={name ?? ""} onChange={...} />  // ◯ 渡すときに空文字へ落とす

|| ではなく ?? を使ってください。 value={num || ""} と書くと、0 が空欄になります(0 は偽と判定されるため)。JavaScriptの回で見た、あの話です。

useState("") に戻して、警告が消えることを確認してから先へ進んでください。

[スクリーンショット: 03_制御警告.png] Console に A component is changing an uncontrolled input to be controlled の警告が出ている状態を撮ってください。

事故2: 数値入力で parseInt すると、小数が打てなくなる

src/ControlledForm.jsx に、数量の欄を足します。

const [qty, setQty] = useState(1);
<label>
  数量
  <input
    type="number"
    value={qty}
    onChange={(e) => setQty(parseInt(e.target.value))}
  />
</label>

もっともらしく見えます。 2つ壊れています。

壊れ方1: 全部消すと NaN になる。

欄の中身を Backspace で全部消してください。e.target.value は "" になり、parseInt("") は NaN(数ではない)を返します。画面には、これが出ます。

Warning: Received NaN for the `value` attribute. If this is expected, cast the value to a string.

そして欄が消せなくなります。 1を消したいだけなのに、消せません。

壊れ方2: 途中の入力が消える。

この parseInt のまま、1.5 と打ってみてください。

打った文字欄の中身(文字列)parseInt の結果React が欄に書き戻す値
1"1"1(同じ数なので書き戻さない)
.5 まで"1.5"11 ← 小数が消える

1.5 と打ったのに 1 になります。 欄の中身を整数に変換した値が欄の文字列と違う数なので、React が数を欄に書き戻してしまったからです。parseFloat に変えれば 1.5 は打てます(React は type="number" の欄では、欄の文字列と state が同じ数なら書き戻しません)。

ただし parseFloat でも、空欄や 1e のような打っている途中の状態では壊れます。

直し方は1つです。

入力欄の state は、必ず文字列のまま持つ。数に変えるのは、送信するときだけ。

const [qty, setQty] = useState("1");   // ← 文字列
<input
  type="number"
  value={qty}
  onChange={(e) => setQty(e.target.value)}   // ← 変換しない
/>
function handleSubmit(e) {
  e.preventDefault();
  const n = Number(qty);                     // ← ここで初めて数にする
  if (!Number.isFinite(n)) {
    console.log("数を入れてください");
    return;
  }
  console.log("送る数量:", n);
}

Number() は parseInt と違い、"12abc" を NaN にします(parseInt("12abc") は 12 を返してしまいます)。入力の検証には Number() のほうが向いています。

これは React の話ではありません。 「入力途中の値は、正しい値ではない」という、フォーム全般の話です。 郵便番号のハイフン挿入、電話番号の整形、金額のカンマ区切り。全部ここで同じ事故が起きます。

事故3: チェックボックスと選択欄は、value ではない

残り2種類を足します。

const [agreed, setAgreed] = useState(false);
const [plan, setPlan] = useState("free");
<label>
  <input
    type="checkbox"
    checked={agreed}
    onChange={(e) => setAgreed(e.target.checked)}
  />
  規約に同意する
</label>

<label>
  プラン
  <select value={plan} onChange={(e) => setPlan(e.target.value)}>
    <option value="free">無料</option>
    <option value="pro">有料</option>
  </select>
</label>

種類ごとに、書く属性と読む場所が違います。表にします。

入力の種類制御するときに書く属性値を読む場所値の型
text / email / number / textareavaluee.target.value常に文字列
checkboxcheckede.target.checked真偽値
radiochecked={plan === "pro"}e.target.value文字列
select<select value>(<option selected> ではない)e.target.value文字列
file制御できないe.target.filesFileList

よくある間違いを2つ。

<input type="checkbox" value={agreed} />        // ❌ 何も起きない

checkbox の value は「チェックが付いたときに送られる文字列」で、チェックの状態ではありません。 ここに true を入れても、チェックは付きません。

<option value="pro" selected>有料</option>       // ❌ React では警告が出る
Warning: Use the `defaultValue` or `value` props on <select> instead of setting `selected` on <option>.

素の HTML では selected を書きますが、React では <select> 側にまとめます。 HTMLの回で書いた素の HTML の書き方と、ここだけ違います。

type="number" でも、e.target.value は文字列です。 "5" であって 5 ではありません。事故2と同じ理由で、そのまま文字列で持つのが正解です。


④ 検証をどこでやるか

ここが、フォームで一番判断を間違えるところです。

まず、JS を1行も書かずにやれることを知る

ブラウザには、最初から検証機能があります。 src/UncontrolledForm.jsx の入力欄に、属性を足すだけです。

<label>
  名前
  <input type="text" name="name" required minLength={2} />
</label>

<label>
  メールアドレス
  <input type="email" name="email" required />
</label>

<label>
  郵便番号
  <input
    type="text"
    name="zip"
    pattern="[0-9]{3}-[0-9]{4}"
    title="123-4567 の形式で入力してください"
  />
</label>

保存して、空のまま送信ボタンを押してください。

送信されません。 かわりに、ブラウザが吹き出しを出して、最初の問題のある欄にフォーカスを移します。 handleSubmit は呼ばれてすらいません。

[スクリーンショット: 04_標準の検証.png] 空のまま送信して、ブラウザ標準の吹き出し(「このフィールドを入力してください」など)が出ているところを撮ってください。

これを、JS を1行も書かずに手に入れました。

属性意味
required空を許さない
type="email"@ を含む形かどうかを見る(厳密な検査ではない)
minLength / maxLength文字数の下限・上限
min / max数値の下限・上限(type="number" と併せて)
pattern正規表現に合う形かどうか
titlepattern に外れたときの説明文。書かないと「形式が違います」としか出ない

type="email" は、実在するアドレスかどうかは1ミリも見ていません。 a@b でも通ります。「@ が1つあって、前後に文字がある」程度の検査です。 これで十分な場面は多いですが、「これで検証した」とは言えません。

そして、標準の検証には限界があります。

  • 文言を変えられない。 「このフィールドを入力してください」は、ブラウザとOSの言語で決まります
  • 見た目を変えられない。 吹き出しのデザインは触れません
  • 「パスワードと確認用が一致するか」のような、欄をまたぐ検査ができない
  • 「そのメールアドレスは登録済みか」のような、サーバーに聞く検査ができない

だから、こうします。

標準の検証を土台にして、足りないところだけ JS で足す。 JS から書き始めない。

JS で全部やりたくなったときは、<form noValidate> を付けて標準検証を止めます。 ただし、止めるとキーボード操作でのフォーカス移動も自分で書くことになります(⑥で扱います)。

JS の検証を、いつ走らせるか

これが本題です。選択肢は3つしかありません。

いつイベント向いているもの向かないもの
入力中onChange文字数カウンタ、パスワードの強度メーターエラー表示(後述)
欄を離れたときonBlur形式の検査全般(メール、郵便番号、必須)重い処理(サーバーに毎回聞く)
送信したときonSubmit欄をまたぐ検査、最終確認、サーバーに聞く検査「打ちながら直したい」人への案内

なぜ「入力中にエラーを出す」が嫌われるのか

やってみると一発で分かります。

メールアドレスの欄に t と1文字打った瞬間、「メールアドレスの形式が正しくありません」と赤字が出ます。ta でも出ます。taro@ でも出ます。正しく打ち終わるまで、ずっと怒られ続けます。

まだ打ち終わっていない人を、打っている最中に責める形になります。

解決は「触ったかどうかを覚えておく」ことです。 これを touched と呼びます。

src/ValidatedForm.jsx(新規)

import { useState } from "react";

function validate(values) {
  const errors = {};
  if (values.name.trim() === "") {
    errors.name = "名前を入力してください";
  }
  if (!values.email.includes("@")) {
    errors.email = "メールアドレスの形式で入力してください";
  }
  if (values.password.length < 8) {
    errors.password = "パスワードは8文字以上にしてください";
  }
  if (values.password !== values.confirm) {
    errors.confirm = "パスワードが一致しません";
  }
  return errors;
}

export default function ValidatedForm() {
  const [values, setValues] = useState({
    name: "",
    email: "",
    password: "",
    confirm: "",
  });
  const [touched, setTouched] = useState({});

  const errors = validate(values);

  function handleChange(e) {
    setValues({ ...values, [e.target.name]: e.target.value });
  }

  function handleBlur(e) {
    setTouched({ ...touched, [e.target.name]: true });
  }

  function handleSubmit(e) {
    e.preventDefault();
    setTouched({ name: true, email: true, password: true, confirm: true });
    if (Object.keys(errors).length > 0) {
      console.log("エラーがあるので送りません:", errors);
      return;
    }
    console.log("送信:", values);
  }

  // 「触ったあと」だけエラーを出すための小道具
  const show = (field) => (touched[field] ? errors[field] : undefined);

  return (
    <form className="card" onSubmit={handleSubmit} noValidate>
      <h2>検証つき</h2>

      <label>
        名前
        <input
          type="text"
          name="name"
          value={values.name}
          onChange={handleChange}
          onBlur={handleBlur}
        />
      </label>
      {show("name") && <p className="error">{show("name")}</p>}

      <label>
        メールアドレス
        <input
          type="email"
          name="email"
          value={values.email}
          onChange={handleChange}
          onBlur={handleBlur}
        />
      </label>
      {show("email") && <p className="error">{show("email")}</p>}

      <label>
        パスワード
        <input
          type="password"
          name="password"
          value={values.password}
          onChange={handleChange}
          onBlur={handleBlur}
        />
      </label>
      {show("password") && <p className="error">{show("password")}</p>}

      <label>
        パスワード(確認)
        <input
          type="password"
          name="confirm"
          value={values.confirm}
          onChange={handleChange}
          onBlur={handleBlur}
        />
      </label>
      {show("confirm") && <p className="error">{show("confirm")}</p>}

      <button type="submit">送信</button>
    </form>
  );
}

src/App.jsx に足して、表示してください。

import ValidatedForm from "./ValidatedForm.jsx";

注目してほしいのは3つです。

1つ目。errors を state で持っていません。

const errors = validate(values);   // 描画のたびに計算し直す

エラーは、値から計算できます。 計算できるものを state に置くと、「値は直したのにエラーが消えない」という矛盾が起きます。useStateとuseReducerの回で見た、同じ事実を2箇所に持ってしまうやつです。

2つ目。touched が表示を制御しています。

打っている最中もエラーは計算されていますが、画面には出ません。 欄から離れた瞬間に、初めて出ます。そして離れたあとは、打ちながら消えていきます(errors は毎回計算し直されるため)。

これが「一度触ってから出す」の正体です。 エラーを出すタイミングと、エラーを消すタイミングは、別でよいのです。 出すのは離れたとき。消すのは直った瞬間。

3つ目。送信時に、全部 touched にしています。

setTouched({ name: true, email: true, password: true, confirm: true });

1つも触らずに送信ボタンを押した人にも、エラーを見せるためです。 これが無いと、押しても何も起きないフォームになります。「押したのに何も起きない」は、フォームで最悪の状態です。

[スクリーンショット: 05_打っている最中.png] メールアドレスの欄に taro とだけ打った状態を撮ってください。まだ赤いエラーが出ていないことが分かる形で。

[スクリーンショット: 06_離れたらエラー.png] そこから Tab で欄を離れ、「メールアドレスの形式で入力してください」が出た状態を撮ってください。

CSS だけでも同じことができる

JS を書かずに「触ってから」をやる方法もあります。

input:user-invalid {
  border-color: #a00;
}

:invalid ではなく :user-invalid です。:invalid は最初から赤くなります(空の必須欄は、開いた瞬間から「無効」なので)。:user-invalid は、その人が一度操作してからでないと当たりません。

考え方は touched と同じです。 ブラウザ側にも同じ答えが用意されている、ということです。

そして、これは防御ではない

ここまで全部、画面の中の話です。

画面側の検証は、正しく使おうとしている人への「親切」です。防御ではありません。

F12 の Console から、こう打てば全部素通りします。

document.querySelector('form').noValidate = true;

そもそもブラウザを使う必要すらありません。 APIの回でやったとおり、curl で直接サーバーを叩けば、画面のコードは1行も動きません。

だから、サーバー側の検証は必ず要ります。 必ずです。

どこ目的無いとどうなるか
画面(React)親切。打ち直しの手間を減らす使いにくい。だが壊れはしない
サーバー(API)防御。壊れたデータを入れさせない誰でも好きなデータを入れられる
データベース最後の砦。NOT NULL や UNIQUEアプリのバグで壊れたデータが残る

サーバー側でどう書くかは、本線のREST API設計の回に置いてあります。 入力を信用しないという話そのものは、セキュリティ点検の回にもあります。

この記事では、画面側だけをやっています。それを忘れないでください。


⑤ 送信 — 再読み込みと、二重送信を止める

e.preventDefault() は何を止めているのか

書かずに試すのが一番早いです。 handleSubmit の1行目をコメントにしてください。

function handleSubmit(e) {
  // e.preventDefault();
  console.log("送信:", values);
}

送信ボタンを押すと、ページが真っ白になって、読み込み直されます。 Console のログも、一瞬出て消えます。

これは、フォーム本来の動作です。 HTML のフォームは、送信するとページごと移動するものでした。action が書かれていなければ、同じURLに送り直します。

React のアプリは、ページが読み込み直された時点で state が全部消えます。 だから止めます。

e.preventDefault();   // ブラウザの「ページを送信して移動する」をやめさせる

戻してから、次へ進んでください。

<button> を <form> の中に置くと、既定で type="submit" になります。 「クリアボタン」のつもりで置いた <button> が、押すたびに送信していたというのは非常によくある事故です。送信しないボタンには type="button" を明示してください。

二重送信を止める

送信に時間がかかると、人はもう一度押します。 ネットが遅い人ほど、必ず2回押します。

押した回数だけ登録されると、同じ注文が2件入ります。

まず、時間のかかる送信を作ります。

src/api.js(新規)

export function fakeSubmit(values) {
  console.log("サーバーへ送った:", values);
  return new Promise((resolve) => {
    setTimeout(() => resolve({ ok: true }), 2000);
  });
}

ValidatedForm.jsx の送信を書き換えます。

import { fakeSubmit } from "./api.js";
const [isSubmitting, setIsSubmitting] = useState(false);
const [done, setDone] = useState(false);
async function handleSubmit(e) {
  e.preventDefault();
  setTouched({ name: true, email: true, password: true, confirm: true });
  if (Object.keys(errors).length > 0) return;

  setIsSubmitting(true);
  try {
    await fakeSubmit(values);
    setDone(true);
  } finally {
    setIsSubmitting(false);   // 失敗しても必ず戻す
  }
}
<button type="submit" disabled={isSubmitting}>
  {isSubmitting ? "送信中…" : "送信"}
</button>
{done && <p>送信しました</p>}

ボタンを連打してみてください。 Console の サーバーへ送った: は1回しか出ません。

finally が要る理由は、非同期処理の回に書いたとおりです。catch を書かずに setIsSubmitting(false) を await の直後に置くと、失敗したときにボタンが「送信中…」のまま永久に固まります。

[スクリーンショット: 07_送信中disabled.png] 送信を押した直後、ボタンが「送信中…」になって押せなくなっている状態を撮ってください。

disabled だけで安心しないでください。 これは画面の中の親切です。同じリクエストが2回届いてもデータが壊れないようにするのは、サーバー側の仕事です(REST API設計の回)。遅い回線では、1回目の送信が届いた後にボタンが無効になることさえあります。


⑥ アクセシビリティの最低線 — フォームだけの話

一般論は本線のアクセシビリティの回にあります。 label と htmlFor の話も、ARIA を安易に使わない話も、そちらです。

ここでは、フォームでしか出てこない3つだけ書きます。

1. ラベルの結び方は2通りある

この記事のコードは、ずっとこう書いてきました。

<label>
  名前
  <input type="text" name="name" />
</label>

<label> の中に <input> を入れる書き方です。 これは結ばれています。 htmlFor は要りません。

ただし、この書き方には制約があります。 エラー文やヒントを間に挟みたくなると、途端に崩れます。 そのときは htmlFor と id で結びます。

<label htmlFor="email">メールアドレス</label>
<input id="email" name="email" type="email" />

id はページの中で一意でなければいけません。 同じフォーム部品を1画面に2つ置いた瞬間に、id がぶつかります。 ラベルをクリックすると、片方の欄にだけフォーカスが飛びます。

だから、囲む書き方(<label> で包む)のほうが安全な場面は多いです。 ただし、次の aria-describedby を使うなら id からは逃げられません。

2. エラー文を、入力欄に結ぶ

これがフォーム固有の話です。

<p className="error">メールアドレスの形式で入力してください</p>

この赤い文字は、目で見ている人には「メールアドレス欄のエラー」だと分かります。 すぐ下にあるからです。

読み上げソフトには、その「すぐ下」が伝わりません。 入力欄に到達したとき読み上げられるのは、ラベルと種類だけです。エラー文は、そこから Tab を進めて偶然たどり着かないと読まれません。

結びます。

<label htmlFor="email">メールアドレス</label>
<input
  id="email"
  name="email"
  type="email"
  value={values.email}
  onChange={handleChange}
  onBlur={handleBlur}
  aria-invalid={show("email") ? true : undefined}
  aria-describedby={show("email") ? "email-error" : undefined}
/>
{show("email") && (
  <p className="error" id="email-error">
    {show("email")}
  </p>
)}
書いたもの伝わること
aria-describedby="email-error"この欄の説明は、id="email-error" の要素にある
aria-invalidこの欄の値は、いま無効である

こう書くと、読み上げソフトは入力欄に来た瞬間に「メールアドレス、編集テキスト、無効なデータ、メールアドレスの形式で入力してください」まで読みます。

エラーが無いときは、属性ごと消してください。 aria-describedby="email-error" のまま、その id の要素が無い状態にすると、結び先が行方不明になります。上のコードで undefined を渡しているのは、属性そのものを出さないためです。

aria-invalid="false" を常に書くのも避けます。 「有効です」とわざわざ言い続ける読み上げになります。

3. 送信して止まったとき、フォーカスを移す

noValidate を付けた瞬間に、自分の仕事になったことがあります。

ブラウザ標準の検証は、止めるだけでなく、最初の問題のある欄にフォーカスを移していました。 JS で検証すると、そこは何もしてくれません。

目で見ている人は、赤い字を探せます。 キーボードだけの人、画面を見ていない人は、いま何が起きたのか分かりません。 ボタンを押した。何も起きなかったように感じる。

移します。

function handleSubmit(e) {
  e.preventDefault();
  const form = e.currentTarget;
  setTouched({ name: true, email: true, password: true, confirm: true });

  const firstError = ["name", "email", "password", "confirm"].find(
    (field) => errors[field]
  );
  if (firstError) {
    form.elements[firstError].focus();   // ← 最初の問題の欄へ飛ばす
    return;
  }
  // 送信処理へ
}

form.elements は、name 属性で入力欄を引ける入れ物です。 form.elements.email で、その欄の DOM が取れます。②で書いた name 属性が、ここでも効いています。

確かめ方は、マウスを使わないことです。

  1. Tab だけでフォームの先頭まで行く
  2. 何も入れずに Enter で送信する
  3. フォーカスが名前の欄に戻り、そこが光っているか

[スクリーンショット: 08_フォーカス移動.png] 空のまま送信したあと、名前の欄にフォーカスの枠が出ている状態を撮ってください。

成功したときも同じ問題が起きます。 「送信しました」という文字を出しただけでは、画面を見ていない人には何も伝わりません。 aria-live を使います(アクセシビリティの回で書いた、あとから出てくるメッセージのやつです)。

<p aria-live="polite">{done ? "送信しました" : ""}</p>

中身が空でも、要素は最初から置いておきます。 要素ごと後から現れると、読み上げソフトが気付かないことがあります。


⑦ ライブラリを入れる前に

ここまで、ライブラリを1つも入れずに書きました。 意図的です。

フォームのライブラリは、実際によく使われます。 名前と役割だけ書いておきます。この記事では入れません。

React Hook Form — 再描画を減らす方の道具

やっていることは、この記事の②そのものです。 入力欄を非制御のまま扱い、値は DOM に持たせ、送信のときだけまとめて読む。 そのうえで、検証・エラー表示・touched の管理という、④で手で書いた部分を引き受けます。

「1文字ごとに全部が再描画される」が起きないのは、そもそも state を更新していないからです。 魔法ではありません。この記事でやったことを、丁寧にやっているだけです。

Zod — 「正しい形」を1箇所に書く方の道具

④の validate 関数を見てください。 if が4本並んでいます。欄が20個になったら、if が20本以上並びます。 そして、同じ検査をサーバー側にもう一度書くことになります。

Zod は、その「形」を、if ではなくスキーマとして書くものです。

// 雰囲気だけ。この記事では入れません
const schema = z.object({
  name: z.string().min(1),
  email: z.string().email(),
  password: z.string().min(8),
});

この定義は、画面でもサーバーでも同じものが使えます。 検証を2箇所に書いて、片方だけ直して食い違うという、いちばん多いバグを防ぐためのものです。

そして、TypeScriptの回を読んでいれば、もう1つの利点が分かります。 スキーマから型が生成できます。 「型は実行時に消える」と書きましたが、Zod は実行時にも残る検査です。 その2つを1箇所で書ける、というのがこれの値打ちです。

結論

どちらも、入れる前に、標準でどこまでできるか知っておいてください。

理由は3つあります。

  1. 入れなくて済む場面が、思ったより多い。 欄が3つの問い合わせフォームに、ライブラリは要りません
  2. 中で何をしているか分からないまま入れると、詰まったときに何も分からない。 「register を書いたのに値が取れない」で止まったとき、name 属性の話を知らないと1歩も動けません
  3. ライブラリは入れ替わる。 FormData と required は入れ替わりません

この記事でやった内容は、ライブラリを入れたあとも全部使えます。 逆はありません。


つまずいたところ

FormData で値が取れず、30分溶かした

非制御版を書いたとき、送信しても空のオブジェクトが出ました。

非制御版の送信: {}

エラーは出ません。警告も出ません。 入力欄には確かに文字が入っています。画面上は何も問題がないように見えます。

原因は name 属性を書いていなかったことでした。 id は書いていました。id では拾いません。

<input type="text" id="name" defaultValue="" />          // ❌ 取れない
<input type="text" id="name" name="name" defaultValue="" />  // ◯

制御コンポーネントに慣れていると、name 属性を書く習慣がありません。 value と onChange があれば動くからです。非制御に切り替えた瞬間に、name が必須になります。

確認の仕方: F12 の Console で、フォームの中身を直接見ます。

[...new FormData(document.querySelector('form')).keys()]

ここに出てこない欄は、name が無い欄です。

value を書いたのに、文字が打てなかった

入力欄が完全に固まりました。 打っても1文字も入りません。

<input type="text" value={name} />   // ❌ onChange が無い

Console に警告が出ていました。

Warning: You provided a `value` prop to a form field without an `onChange` handler.
This will render a read-only field.

「value を渡したのに onChange が無いので、読み取り専用になります」 です。

制御コンポーネントの value は、「初期値」ではありません。 「常にこの値であれ」という指示です。 打った文字は一瞬 DOM に入りますが、React が即座に value の中身で上書きします。だから固まったように見えます。

わざと読み取り専用にしたいときは、意思を明示します。

<input type="text" value={name} readOnly />

value={undefined} の警告を、無視して進んで痛い目に遭った

②の警告が出たとき、「動いているから」と無視しました。

後で困ったのは、フォームを「リセット」したときです。

setValues({ name: undefined, email: undefined });   // ❌

リセットしたつもりで、制御から非制御へ逆向きに切り替わりました。 出た警告は、こちらです。

Warning: A component is changing a controlled input to be uncontrolled.

そして画面上は、値が消えずに残りました。 React が値を管理しなくなっただけで、DOM の中身はそのまま残るからです。

リセットは、空文字に戻します。

setValues({ name: "", email: "" });   // ◯

非制御なら、これ1行です。

e.currentTarget.reset();   // フォーム全体を初期値に戻す

onChange が、思っていたタイミングで呼ばれなかった

素の HTML の onchange は、「欄を離れたとき」に1回だけ発火します。 React の onChange は、1文字ごとに発火します。

名前は同じですが、動きが違います。 React の onChange は、中身としては DOM の input イベントです。

「離れたとき」がほしいなら、React でも onBlur を使います。 ④でそうしました。

日本語を打っている途中で、検証が走った

メールアドレスではなく、名前の欄で気付きました。 「たろう」と打って変換する前、まだ「たろう」がひらがなで下線付きになっている状態でも onChange が走ります。

この「変換中」の状態を、IME 変換中(composition)と呼びます。 onCompositionStart と onCompositionEnd で、変換中かどうかを知ることはできます。

ただし、この記事のやり方なら困りません。 touched(=欄を離れたか)で表示を制御しているからです。 変換中に欄を離れることはありません。

「入力中に検証する」をやめると、この問題ごと消えます。 日本語のフォームで onChange 検証を避ける理由が、もう1つあるということです。

ボタンを押したら、ページが再読み込みされた

「クリア」ボタンでした。

<button onClick={handleClear}>クリア</button>   // ❌ 送信されている

<form> の中の <button> は、既定で type="submit" です。 handleClear は動いたあと、そのまま送信も走ります。

<button type="button" onClick={handleClear}>クリア</button>   // ◯

送信しないボタンには、必ず type="button" を書くと覚えてください。

ブラウザが読み込み中のまま止まる

Vite は起動しているのに、ホストのブラウザが何も出しません。

ポートです。 VM の中で確認します。

bash
$ sudo ufw status
$ ss -ltn | grep 5181

5181/tcp ALLOW が無ければ、①のポート開放を飛ばしています。 ss に何も出なければ、--host 0.0.0.0 を付け忘れています(付けないと VM の中からしか繋がりません)。


後片づけ

開発サーバーを止める

起動しているターミナルで Ctrl+C。

bash
$ ss -ltn | grep 5181

確認: 何も出なければ、止まっています。

ポートを閉じる

開けっぱなしにしません。

bash
$ sudo ufw delete allow 5181/tcp
$ sudo ufw status

確認: 5181/tcp の行が消えていれば成功です。5173番は、本線で使うので残してあります。

プロジェクトを消す

~/reactlab/ は、この記事のためだけに作りました。

bash
$ rm -rf ~/reactlab
$ ls ~

確認: reactlab が消えて、react-demo が残っていること。

残しておきたい場合は、node_modules だけ消せば数百MB空きます。

bash
$ du -sh ~/reactlab/node_modules
$ rm -rf ~/reactlab/node_modules

戻すときは cd ~/reactlab && npm install だけです(npmの回)。

bash
$ ls ~/react-demo/src

確認: 本線のファイル一覧が出れば、無事です。~/react-demo/ は絶対に消さないでください。 本線がその続きで進みます。


まとめ

  • 入力欄の作り方は2種類ある。制御(値を React が持つ)と非制御(値を DOM が持つ)。 どちらが正解ということはなく、混ぜてよい
  • 判断は1つの問いで決まる。 入力している最中に何かをしたいか。したいなら制御、送信時に取れればよいなら非制御
  • 非制御は defaultValue と name 属性を書き、送信時に new FormData(e.currentTarget) で読む。 name が無い欄は、警告も出ずに消える
  • type="file" は制御できない。 非制御しか選べない
  • 「1文字打つたびに重い」の原因は、制御コンポーネントではなく state の置き場所。 state をそれが要る部品まで降ろすだけで止まる
  • value={undefined} から始めると、後から uncontrolled input to be controlled の警告が出る。 初期値は空文字にする
  • value を書いて onChange を書かないと、読み取り専用になって1文字も打てない
  • 数値入力で parseInt してはいけない。 "1.5" が 1 に書き戻されて小数が打てず、空にすると NaN になる。state は文字列のまま持ち、送信時に Number() する
  • チェックボックスは checked と e.target.checked。 選択欄は <option selected> ではなく <select value>
  • type="number" でも e.target.value は文字列
  • 検証は、まずブラウザ標準(required / type="email" / pattern)でどこまで行けるか見る。 JS から書き始めない
  • type="email" は実在確認をしていない。 a@b も通る
  • JS の検証は3択(送信時 / 離れたとき / 入力中)。 入力中にエラーを出すのは嫌われる。「一度触ってから」出す
  • エラーは state に持たない。値から毎回計算する。 出すタイミングを touched で制御する
  • 送信時には、全部を touched にする。 でないと「押しても何も起きないフォーム」になる
  • 画面側の検証は親切であって、防御ではない。 サーバー側の検証は必ず要る
  • e.preventDefault() が止めているのは「ページごと送信して移動する」というフォーム本来の動作
  • <form> の中の <button> は既定で送信ボタン。 送信しないものには type="button" を書く
  • 二重送信は disabled={isSubmitting} で止める。 finally で必ず戻さないと、失敗したとき永久に固まる
  • フォームのアクセシビリティは3つ。 ラベルを結ぶ / aria-describedby でエラーを結ぶ / 止まったらフォーカスを移す
  • noValidate を付けた時点で、フォーカス移動は自分の仕事になる
  • React Hook Form と Zod を入れる前に、標準でどこまでできるか知っておく。 FormData と required は入れ替わらない

参考リンク


次に読む

この記事は 【深掘り】React の 10 / 24 本目です。

記事
← 前の記事カスタムフック — 似ているだけでは共通化しない
→ 次の記事リストのkey — 添字を使うとチェックがズレる

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›React — Forms
  • 制御と非制御を再描画回数で比べる
  • 検証をどこでやるか

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次