- Day 17:Reactでお問い合わせフォームを作る
- 1. フォームを作る前に知っておくこと
- 2. controlled componentとは
- 3. Next.jsでフォームを作る準備
- 4. input、textarea、selectの役割
- 5. お問い合わせフォームを作る
- 6. フォームのコードを順番に読む
- 7. onChangeでイベントオブジェクトを使う
- 8. onSubmitとpreventDefault()
- 9. requiredなどの入力チェック
- 10. name属性も付ける
- 11. controlled componentと非制御フォーム
- 12. 送信結果を画面に表示する改善例
- 13. セキュリティと個人情報の注意点
- 14. よくあるつまずき
- 15. Day 17のチェックリスト
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>
);
}JSXvalue={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("フォームを送信します");
}JSX9. 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)}
/>JSX11. 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を更新する」「送信時に値を確認する」という流れが基本です。まずは学習用フォームを動かして、名前や本文の入力、種別の選択、送信後のメッセージ表示を試してみましょう。実際に問い合わせを送る機能へ進む際は、サーバー側の処理と個人情報の安全な取り扱いを追加してください。
