Next.jsで学ぶReact講座 90日コース | React実践力を身につける - Day 29:フォームバリデーション

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 29:フォームバリデーションで会員登録フォームを作る

フォームバリデーションとは、入力された内容が条件を満たしているか確認することです。この日は、必須入力・文字数・メールアドレス形式・パスワード確認を検証し、入力欄ごとにエラーメッセージを表示する会員登録フォームを作ります。

今回作るのはバリデーションの練習用フォームです。画面上で入力を確認しますが、実際に会員アカウントは作成しません。実際の登録では、サーバー側でも同じように入力を検証し、パスワードを安全に扱う必要があります。

1. フォームの入力項目とルールを決める

入力条件があいまいなまま作り始めると、エラーメッセージや入力欄の挙動が一貫しなくなります。まず、項目とルールを決めます。

  • 名前:必須、前後の空白を除いて2〜50文字。
  • メールアドレス:必須、形式を確認。
  • パスワード:必須、12〜128文字。
  • パスワード確認:必須、パスワードと一致。

ここでの文字数ルールは教材用の例です。実際のサービスでは、利用目的やセキュリティ要件に合わせて決めてください。

2. Next.jsのページを用意する

App Routerを使っている場合は、app/page.jsまたはsrc/app/page.jsを使います。入力欄のStateや送信イベントを扱うため、Client Componentとして作ります。

my-app/
└── app/
    └── page.js

3. バリデーションの考え方

入力内容のチェックは、入力欄の値を使って検証し、エラーを表示します。今回のコードでは、送信時にすべての入力を確認します。

// 例:入力値から問題のある項目を調べる関数です<br>function validateForm(values) {<br>  const errors = {};<br><br>  // 必須チェック、形式チェックなどをここで行います<br><br>  return errors;<br>}
JavaScript

エラーがある場合はerrorsに項目ごとのメッセージを入れ、エラーがなければ空のオブジェクトを返すようにします。

4. 会員登録フォームの完成コード

次のコードをapp/page.jsまたはsrc/app/page.jsに記述します。送信前に必須項目・文字数・メール形式・パスワード一致を確認し、入力欄の近くにエラーを表示します。

// このファイルをClient Componentとして扱います
"use client";

// Reactの状態管理機能を読み込みます
import { useState } from "react";

// 空の入力値を作る関数です
function createEmptyValues() {
  return {
    name: "",
    email: "",
    password: "",
    confirmPassword: "",
  };
}

// 入力値を検証し、項目ごとのエラーを返します
function validateForm(values) {
  // エラーがある項目だけ、ここにメッセージを入れます
  const errors = {};

  // 名前の前後の空白を取り除いて検証します
  const trimmedName = values.name.trim();

  // 名前が入力されているか確認します
  if (trimmedName === "") {
    errors.name = "名前を入力してください。";
  } else if (trimmedName.length < 2 || trimmedName.length > 50) {
    // 名前が指定した文字数の範囲か確認します
    errors.name = "名前は2〜50文字で入力してください。";
  }

  // メールアドレスの前後の空白を取り除きます
  const trimmedEmail = values.email.trim();

  // メール欄が空でないか確認します
  if (trimmedEmail === "") {
    errors.email = "メールアドレスを入力してください。";
  } else {
    // 入力形式の簡易チェックです。サーバー側の検証も必要です
    const simpleEmailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;

    // 簡易パターンに一致するか確認します
    if (!simpleEmailPattern.test(trimmedEmail)) {
      errors.email = "メールアドレスの形式を確認してください。";
    }
  }

  // パスワードが入力されているか確認します
  if (values.password === "") {
    errors.password = "パスワードを入力してください。";
  } else if (
    values.password.length < 12 ||
    values.password.length > 128
  ) {
    // パスワードの長さが範囲内か確認します
    errors.password = "パスワードは12〜128文字で入力してください。";
  }

  // 確認用パスワードが入力されているか確認します
  if (values.confirmPassword === "") {
    errors.confirmPassword = "確認用パスワードを入力してください。";
  } else if (values.confirmPassword !== values.password) {
    // 2つのパスワードが一致するか確認します
    errors.confirmPassword = "パスワードが一致しません。";
  }

  // エラーがなければ空のオブジェクトを返します
  return errors;
}

// 会員登録フォームの練習ページです
export default function RegistrationPage() {
  // 入力欄の値をまとめて管理します
  const [values, setValues] = useState(createEmptyValues);

  // 入力欄ごとのエラーを管理します
  const [errors, setErrors] = useState({});

  // 送信後の案内メッセージを管理します
  const [message, setMessage] = useState("");

  // フォームの入力内容を更新します
  function handleChange(event) {
    // 入力欄のnameとvalueを取り出します
    const { name, value } = event.target;

    // 変更された入力欄だけ新しい値に置き換えます
    setValues((currentValues) => ({
      ...currentValues,
      [name]: value,
    }));

    // 入力を直し始めたら送信後メッセージを消します
    setMessage("");
  }

  // フォーム送信時に入力内容を検証します
  function handleSubmit(event) {
    // ブラウザー標準のページ再読み込みを防ぎます
    event.preventDefault();

    // すべての入力値を検証します
    const validationErrors = validateForm(values);

    // 検証結果を画面に反映します
    setErrors(validationErrors);

    // エラーがひとつでもあれば処理を終了します
    if (Object.keys(validationErrors).length > 0) {
      setMessage("入力内容を確認してください。");
      return;
    }

    // この教材では実際のアカウント登録は行いません
    setMessage(
      "入力チェックに成功しました。実際の登録処理にはサーバーとの接続が必要です。"
    );
  }

  return (
    <main>
      <h1>会員登録</h1>
      <p>入力内容を確認して、フォームの使い方を学びます。</p>

      {/* 送信時に入力内容を検証するフォームです */}
      <form onSubmit={handleSubmit} noValidate>
        {/* 名前の入力欄です */}
        <div>
          <label htmlFor="name">名前</label>
          <input
            id="name"
            name="name"
            type="text"
            value={values.name}
            onChange={handleChange}
            autoComplete="name"
            maxLength={50}
            required
            aria-invalid={Boolean(errors.name)}
            aria-describedby={errors.name ? "name-error" : undefined}
          />

          {/* 名前にエラーがある場合だけ表示します */}
          {errors.name && (
            <p id="name-error" role="alert">
              {errors.name}
            </p>
          )}
        </div>

        {/* メールアドレスの入力欄です */}
        <div>
          <label htmlFor="email">メールアドレス</label>
          <input
            id="email"
            name="email"
            type="email"
            value={values.email}
            onChange={handleChange}
            autoComplete="email"
            maxLength={254}
            required
            aria-invalid={Boolean(errors.email)}
            aria-describedby={errors.email ? "email-error" : undefined}
          />

          {/* メールアドレスにエラーがある場合だけ表示します */}
          {errors.email && (
            <p id="email-error" role="alert">
              {errors.email}
            </p>
          )}
        </div>

        {/* パスワードの入力欄です */}
        <div>
          <label htmlFor="password">パスワード</label>
          <input
            id="password"
            name="password"
            type="password"
            value={values.password}
            onChange={handleChange}
            autoComplete="new-password"
            minLength={12}
            maxLength={128}
            required
            aria-invalid={Boolean(errors.password)}
            aria-describedby={
              errors.password ? "password-error password-help" : "password-help"
            }
          />

          {/* 入力条件を事前に案内します */}
          <p id="password-help">12〜128文字で入力してください。</p>

          {/* パスワードにエラーがある場合だけ表示します */}
          {errors.password && (
            <p id="password-error" role="alert">
              {errors.password}
            </p>
          )}
        </div>

        {/* 確認用パスワードの入力欄です */}
        <div>
          <label htmlFor="confirmPassword">パスワード(確認)</label>
          <input
            id="confirmPassword"
            name="confirmPassword"
            type="password"
            value={values.confirmPassword}
            onChange={handleChange}
            autoComplete="new-password"
            maxLength={128}
            required
            aria-invalid={Boolean(errors.confirmPassword)}
            aria-describedby={
              errors.confirmPassword
                ? "confirm-password-error"
                : undefined
            }
          />

          {/* 確認用パスワードにエラーがある場合だけ表示します */}
          {errors.confirmPassword && (
            <p id="confirm-password-error" role="alert">
              {errors.confirmPassword}
            </p>
          )}
        </div>

        {/* 送信ボタンです */}
        <button type="submit">入力内容を確認</button>

        {/* 送信結果の案内を表示します */}
        <p aria-live="polite">{message}</p>
      </form>
    </main>
  );
}
JSX

5. validateFormの仕組み

validateFormは、入力値を受け取り、問題のある項目をerrorsに記録します。たとえば、名前が空ならerrors.nameにエラーメッセージを入れます。

// 入力値を検証する例です<br>if (values.name.trim() === "") {<br>  errors.name = "名前を入力してください。";<br>}
JavaScript

最後にerrorsを返します。エラーがない場合は空のオブジェクトなので、Object.keys(errors).lengthは0になります。

// オブジェクトのキー数が0ならエラーなしです
const hasErrors = Object.keys(errors).length > 0;
JavaScript

検証処理をフォームの表示部分から分けると、条件を探しやすくなります。別のフォームでも同じルールを使いたい場合は、検証関数を別ファイルに分ける方法もあります。

6. HTMLの属性と独自バリデーション

コードでは、required、type="email"、minLength、maxLengthなどのHTML属性も指定しています。これらは、ブラウザーの入力支援や制約チェックに役立ちます。

ただし、完成コードではフォームにnoValidateを指定しています。ブラウザー標準の検証メッセージではなく、Reactで作ったメッセージを表示するためです。属性を外せば、ブラウザー標準の検証動作も試せます。

HTML側のチェックとJavaScript側のチェックは、互いに補助し合うものです。どちらかだけで実際のデータを安全に扱えるわけではありません。

7. メール形式チェックの限界

今回の正規表現は、空白や@の位置などを確認する簡易チェックです。メールアドレスのあらゆる有効・無効な形式を完全に判定するものではありません。

また、形式が正しく見えるアドレスでも、実際に受信できるとは限りません。実サービスでは、サーバー側で登録処理を行ったうえで、確認メールを送る方法などを検討します。メール形式のチェックだけで、本人のメールアドレスだと確認できるわけではありません。

8. サーバー側でも検証する

ブラウザー側のバリデーションは、入力しやすさを高めるためのものです。利用者はブラウザーの設定や通信内容を変更できるため、クライアント側のチェックだけで登録データを信用してはいけません。

実際の会員登録では、サーバー側でも次のような検証が必要です。

  • 必須項目、文字数、形式を再確認します。
  • 入力された値を安全に処理し、データベースへ保存します。
  • パスワードは平文で保存せず、適切なパスワードハッシュ化を行います。
  • 登録APIに対する不正な連続送信なども考慮します。

この教材のコードでは、入力成功のメッセージを出すだけで、パスワードを保存・送信しません。

9. アクセシビリティへの配慮

フォームでは、エラー文を表示するだけでなく、どの入力欄のエラーか分かるようにします。コードでは、次の属性を使っています。

  • labelとhtmlForで、入力欄とラベルを結び付けています。
  • aria-invalidで、入力欄がエラー状態かを伝えています。
  • aria-describedbyで、入力欄に対応する説明やエラーを関連付けています。
  • role="alert"やaria-liveで、メッセージの更新を支援技術に伝えます。

エラーの色だけで状態を伝えるのではなく、文章でも説明しましょう。

10. よくあるつまずき

  • 空白だけの入力が通ってしまう:文字列を`trim()`してから必須チェックします。
  • 入力欄の値が更新されない:`value`と`onChange`が同じStateを使っているか確認します。
  • エラー表示が別の欄に出る:`errors.name`のように項目ごとにエラーを分けます。
  • メールアドレスの正規表現に頼りすぎる:簡易チェックであることを理解し、実際の確認はサーバー側でも行います。
  • パスワードを画面に表示してしまう:`type=”password”`を使い、エラーメッセージに入力値を含めないようにします。
  • 画面側の検証だけで登録処理を作る:サーバー側の再検証、保存処理、パスワードの安全な扱いが別途必要です。

11. 練習課題

完成したら、次の変更に挑戦してみましょう。

  • 名前の文字数ルールを変更します。
  • エラーを送信時ではなく、入力欄からフォーカスが外れたときにも表示します。
  • すべての入力欄が正しくなるまで送信ボタンを無効にします。
  • 利用規約への同意チェックを追加します。
  • エラーがある場合、送信後に最初のエラー入力欄へフォーカスします。

12. Day 29のチェックリスト

  • 必須入力を検証できます。
  • 文字数の範囲を検証できます。
  • メール形式を簡易チェックできます。
  • パスワードと確認用パスワードを比較できます。
  • 入力欄ごとにエラーメッセージを表示できます。
  • ラベルとエラーを入力欄に関連付けられます。
  • クライアント側の検証だけでは安全な登録処理にならないと理解しています。

フォームバリデーションでは、入力条件を決め、入力値を検証し、どこをどう直せばよいか利用者に伝えます。今回のフォームでクライアント側の基本を練習したら、次はサーバー側でも同じ条件を確認する構成へ進みましょう。

タイトルとURLをコピーしました