Next.jsで学ぶReact講座 90日コース | React基礎 - Day 17:フォーム

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

Day 17:Reactでお問い合わせフォームを作る

Reactのフォームでは、入力欄の値をStateとして管理し、利用者の入力に合わせて更新できます。このように、ReactのStateと入力欄の値を同期させる方法をcontrolled component(制御されたコンポーネント)と呼びます。

この日は、input、textarea、selectを使ったお問い合わせフォームを作ります。入力内容を確認して送信し、送信後に画面へ完了メッセージを表示します。

1. フォームを作る前に知っておくこと

お問い合わせフォームには、たとえば次の項目があります。

  • 名前:`input`で一行の文字を入力します。
  • メールアドレス:`input type=”email”`で入力します。
  • お問い合わせ種別:`select`で選択します。
  • お問い合わせ内容:`textarea`で複数行の文章を入力します。

利用者が入力した内容をReact側でも使うため、入力値をStateで管理します。送信時はフォームのonSubmitで処理し、ページの再読み込みを防ぐためにevent.preventDefault()を呼び出します。(🔗 react.dev) (🔗 react.dev)

2. controlled componentとは

controlled componentでは、入力欄のvalueをStateから設定し、入力のたびにonChangeでStateを更新します。

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

// 名前を入力するコンポーネントです
function NameField() {
  // 入力欄の値をStateで管理します
  const [name, setName] = useState("");

  return (
    <label>
      名前
      <input
        // 入力欄の表示値をStateと同期させます
        value={name}
        // 入力されるたびにStateを更新します
        onChange={(event) => setName(event.target.value)}
      />
    </label>
  );
}
JSX

value={name}だけを指定してonChangeでStateを更新しないと、入力欄の表示がStateの値から変わらず、文字を入力できない状態になることがあります。controlled inputでは、valueとonChangeをセットで使います。(🔗 react.dev)

3. Next.jsでフォームを作る準備

App Routerを使っている場合、ページファイルはapp/page.jsまたはsrc/app/page.jsです。今回のフォームではuseStateとイベント処理を使うため、Client Componentにします。'use client'はファイルの先頭に記述します。(🔗 nextjs.org)

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

srcフォルダーを使っている場合は、次のようになります。

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

開発サーバーが動いていない場合は、プロジェクトのフォルダーで起動します。

# Next.jsの開発サーバーを起動します
npm run dev

4. input、textarea、selectの役割

フォームでは、入力する内容に合ったHTML要素を選びます。

  • input:名前、メールアドレスなど、一行で入力する項目に使います。
  • textarea:お問い合わせ内容など、複数行の文章に使います。
  • select:候補からひとつ選ぶ項目に使います。

Reactでは、これらの値をStateに結びつけます。inputとtextareaは主にvalue、選択欄のselectもvalueで現在の選択を指定します。

5. お問い合わせフォームを作る

次のコードをapp/page.jsまたはsrc/app/page.jsに記述します。名前、メールアドレス、お問い合わせ種別、本文の入力値をStateで管理します。

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

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

// お問い合わせフォームのページです
export default function ContactPage() {
  // 名前の入力値を管理します
  const [name, setName] = useState("");

  // メールアドレスの入力値を管理します
  const [email, setEmail] = useState("");

  // 選択されたお問い合わせ種別を管理します
  const [category, setCategory] = useState("general");

  // お問い合わせ本文を管理します
  const [message, setMessage] = useState("");

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

  // フォーム送信時に実行する関数です
  function handleSubmit(event) {
    // ブラウザー標準の送信によるページ再読み込みを防ぎます
    event.preventDefault();

    // 入力の前後にある空白を除いて確認します
    if (
      name.trim() === "" ||
      email.trim() === "" ||
      message.trim() === ""
    ) {
      // 必須項目が不足している場合は案内を表示します
      setStatusMessage("必須項目を入力してください。");
      return;
    }

    // 学習用として送信内容をコンソールに表示します
    console.log({
      name: name.trim(),
      email: email.trim(),
      category,
      message: message.trim(),
    });

    // 送信できたことを画面に表示します
    setStatusMessage("お問い合わせ内容を確認しました。");

    // 送信後に入力欄を初期値へ戻します
    setName("");
    setEmail("");
    setCategory("general");
    setMessage("");
  }

  return (
    <main>
      <h1>お問い合わせ</h1>
      <p>以下のフォームに必要事項を入力してください。</p>

      {/* フォーム送信をhandleSubmitで処理します */}
      <form onSubmit={handleSubmit}>
        <div>
          <label htmlFor="name">お名前</label>
          <input
            id="name"
            name="name"
            type="text"
            value={name}
            onChange={(event) => setName(event.target.value)}
            autoComplete="name"
            required
            maxLength={80}
          />
        </div>

        <div>
          <label htmlFor="email">メールアドレス</label>
          <input
            id="email"
            name="email"
            type="email"
            value={email}
            onChange={(event) => setEmail(event.target.value)}
            autoComplete="email"
            required
          />
        </div>

        <div>
          <label htmlFor="category">お問い合わせ種別</label>
          <select
            id="category"
            name="category"
            value={category}
            onChange={(event) => setCategory(event.target.value)}
          >
            <option value="general">一般的なお問い合わせ</option>
            <option value="service">サービスについて</option>
            <option value="other">その他</option>
          </select>
        </div>

        <div>
          <label htmlFor="message">お問い合わせ内容</label>
          <textarea
            id="message"
            name="message"
            value={message}
            onChange={(event) => setMessage(event.target.value)}
            rows={6}
            maxLength={2000}
            required
          />
        </div>

        {/* type="submit"でフォームを送信します */}
        <button type="submit">内容を確認する</button>
      </form>

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

このコードはブラウザー上で入力内容を確認し、送信内容をコンソールに表示する学習用のサンプルです。実際のメール送信やデータ保存は行いません。

6. フォームのコードを順番に読む

このフォームの処理は、次の順序で動きます。

  • useStateで各入力欄の初期値を用意します。
  • 入力欄のvalueにStateを指定します。
  • 入力のたびにonChangeが動き、event.target.valueをStateに保存します。
  • 送信ボタンを押すかEnterキーで送信すると、onSubmitが動きます。
  • event.preventDefault()でページ再読み込みを防ぎます。
  • 必須項目を確認し、送信完了メッセージを表示します。
  • 送信後、Stateを空の値や初期値へ戻します。

入力値のStateを画面表示の基準にしているため、入力欄の表示とReactのデータが一致します。

7. onChangeでイベントオブジェクトを使う

onChangeの関数には、イベントオブジェクトが渡されます。event.target.valueで入力欄や選択欄の現在の値を読み取れます。

// 入力欄の変更を受け取る例です
function handleNameChange(event) {
  // 入力要素の値をStateに保存します
  setName(event.target.value);
}
JSX

関数を直接書かず、名前付き関数に分けても同じです。

// 入力欄の変更を処理する関数です
function handleNameChange(event) {
  // event.target.valueには現在の入力文字列が入っています
  setName(event.target.value);
}

// 関数をイベントハンドラーとして渡します
<input value={name} onChange={handleNameChange} />
JSX

入力欄のevent.target.valueは文字列です。数値を扱う入力欄では、計算に使う前に変換と確認が必要です。

8. onSubmitとpreventDefault()

フォームを送信すると、ブラウザーは通常の動作としてページを再読み込みすることがあります。React内で送信処理を行う場合は、event.preventDefault()で標準動作を止めます。フォームの送信はボタンのクリックだけでなく、入力欄でEnterキーを押した場合にも起きるため、ボタンのonClickではなくフォームのonSubmitで処理するのが適切です。(🔗 react.dev)

// フォーム送信を処理します
function handleSubmit(event) {
  // ページの再読み込みを止めます
  event.preventDefault();

  // React内で行いたい送信処理を続けます
  console.log("フォームを送信します");
}
JSX

9. requiredなどの入力チェック

HTMLには、基本的な入力チェックを行う属性があります。

  • required:入力を必須にします。
  • type="email":メールアドレス形式として妥当か、ブラウザーの基本チェックを使います。
  • maxLength:入力できる文字数の上限を設定します。

これらは利用者の入力を助けるものですが、サーバー側の検証の代わりにはなりません。ブラウザーのチェックだけに頼らず、実際にデータを受け取るサーバーでも内容を検証する必要があります。(🔗 nextjs.org)

10. name属性も付ける

各入力要素にnameを付けておくと、フォームのデータを扱うときに項目を識別できます。たとえばFormDataを使う方法では、nameがデータを取り出すためのキーになります。(🔗 react.dev)

// name属性を付けた入力欄の例です
<input
  name="email"
  type="email"
  value={email}
  onChange={(event) => setEmail(event.target.value)}
/>
JSX

11. controlled componentと非制御フォーム

今回の例では、各入力値をuseStateで管理するcontrolled componentを使っています。入力値に応じて表示を変えたり、入力内容を細かく確認したりしたいときに扱いやすい方法です。

フォームの内容を送信時にまとめて取得する方法もあります。ReactではFormDataを使う例があり、フォーム要素にnameを付けておくと値を読み取れます。(🔗 react.dev)

// フォーム送信時にFormDataから値を読む例です
function handleSubmit(event) {
  // ブラウザー標準のページ再読み込みを防ぎます
  event.preventDefault();

  // 送信されたフォームからFormDataを作ります
  const formData = new FormData(event.currentTarget);

  // name属性をキーとして値を取得します
  const name = formData.get("name");
  const email = formData.get("email");

  // 取得した値を確認します
  console.log({ name, email });
}
JSX

学習では、まずcontrolled componentで入力とStateの関係を理解しましょう。フォームが大きくなった場合は、フォームデータの取得方法やフォームライブラリを検討することもあります。

12. 送信結果を画面に表示する改善例

学習用サンプルではconsole.log()に送信内容を表示しましたが、利用者には画面内のメッセージを表示する方が分かりやすいです。個人情報を含む送信内容を、必要もないのにコンソールへ出力しないようにしましょう。

完了メッセージは、コード内のstatusMessageのようにStateで管理できます。送信中の状態を加えれば、送信ボタンを一時的に無効にすることもできます。

// 送信中かどうかを管理するStateの例です
const [isSubmitting, setIsSubmitting] = useState(false);

// 送信ボタンを状態に応じて表示します
<button type="submit" disabled={isSubmitting}>
  {isSubmitting ? "送信中..." : "内容を確認する"}
</button>
JSX

この例だけでは実際の通信処理はありません。送信中表示を使うには、サーバーへの送信処理と、その完了・失敗時のState更新も追加します。

13. セキュリティと個人情報の注意点

お問い合わせフォームでは、名前やメールアドレスなどの個人情報を扱う可能性があります。学習用コードと実サービスの運用は分けて考えてください。

  • ブラウザー側の入力チェックだけを信用せず、サーバー側でも入力を検証します。
  • APIキーやメール送信サービスの秘密鍵を、ブラウザーに配信されるClient Componentへ書かないでください。
  • 送信データを必要以上にコンソールやログへ残さないでください。
  • 実際の問い合わせを送る場合は、サーバー側の処理、スパム対策、個人情報の扱いを設計します。
  • 送信内容を画面に表示する場合も、ユーザー入力をHTMLとして直接挿入しないようにします。

Next.jsではServer Actionsなど、サーバー側でフォームを処理する方法もあります。実際に問い合わせを送信する機能を作る段階では、サーバー側での検証や安全な送信方法を学び、公開ドキュメントに沿って実装してください。(🔗 nextjs.org)

14. よくあるつまずき

  • 入力欄に文字を入力できない:`value`をStateに結びつけた場合、`onChange`でStateを更新しているか確認します。
  • フォーム送信時にページが再読み込みされる:`onSubmit`の中で`event.preventDefault()`を呼んでいるか確認します。
  • ラベルをクリックしても入力欄に移動しない:`label`の`htmlFor`と入力欄の`id`が一致しているか確認します。
  • 選択内容が変わらない:`select`の`value`と`onChange`で同じStateを使っているか確認します。
  • 送信処理が動かない:ボタンが`type=”submit”`で、フォームに`onSubmit`を設定しているか確認します。
  • useStateを使うとエラーになる:App Routerでは、イベント処理を行うファイル先頭に`’use client’`があるか確認します。

15. Day 17のチェックリスト

  • input、textarea、selectの使い分けが分かります。
  • valueとonChangeで入力値をStateと同期できます。
  • event.target.valueで入力内容を取得できます。
  • onSubmitでフォーム送信を処理できます。
  • event.preventDefault()で標準のページ再読み込みを防げます。
  • requiredやtype="email"などを使って基本的な入力チェックを設定できます。
  • クライアント側の入力チェックだけでは不十分で、実運用ではサーバー側の検証も必要だと分かります。
  • お問い合わせ内容を実際に送るには、別途サーバー側の送信処理が必要だと理解しています。

フォームでは、「入力欄の値をStateで管理する」「入力時にStateを更新する」「送信時に値を確認する」という流れが基本です。まずは学習用フォームを動かして、名前や本文の入力、種別の選択、送信後のメッセージ表示を試してみましょう。実際に問い合わせを送る機能へ進む際は、サーバー側の処理と個人情報の安全な取り扱いを追加してください。

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