Day 23:コンポーネント設計
コンポーネント設計では、画面を役割ごとに分け、それぞれが何を担当するかを明確にします。この日は、Day 22のユーザー検索アプリを例に、データ取得やState管理を担当するContainer的なコンポーネントと、表示を担当するPresentational Componentに分けます。
この分け方は必須のルールではなく、複雑な画面を整理するための考え方です。コンポーネントを細かく分けること自体が目的ではありません。読みやすさ、変更のしやすさ、再利用のしやすさが向上するかを基準にします。
1. 巨大なコンポーネントの困りごと
検索フォーム、API通信、エラー表示、ユーザー一覧がすべて1つのコンポーネントに入っていると、処理が増えるにつれて見通しが悪くなります。
// 例:データ処理と画面表示がひとつに集まったコンポーネントです
function UserSearchPage() {
// State、検索処理、入力欄、結果一覧、エラー表示などが
// この関数の中にすべて書かれていると、変更箇所を探しにくくなります
return (
<main>
{/* フォーム、状態表示、ユーザー一覧などが続きます */}
</main>
);
}JSXこの状態では、「検索ボタンの表示だけ変えたい」「ユーザーカードのデザインを直したい」といった作業でも、長いコンポーネントの中から該当箇所を探すことになります。
そこで、画面を役割に沿って分けます。
- 検索とState管理:検索の流れを管理します。
- 検索フォーム:入力欄と検索ボタンを表示します。
- 状態メッセージ:読み込み中、エラー、検索結果なしを表示します。
- ユーザー一覧:複数のユーザーを並べます。
- ユーザーカード:ユーザー1人分を表示します。
2. Presentational Componentとは
Presentational Componentは、主に表示を担当するコンポーネントです。Propsで受け取った値を画面に表示し、利用者の操作があれば親へ伝えます。
たとえば、ユーザーカードは「ユーザーのデータをどう取得するか」は考えず、受け取ったユーザー情報を表示することに集中できます。
// Propsで受け取ったユーザー情報を表示するコンポーネントです
function UserCard({ user }) {
return (
<article>
<h2>
{user.firstName} {user.lastName}
</h2>
<p>{user.email}</p>
</article>
);
}JSX3. Container的な考え方
Container的なコンポーネントは、画面のデータや処理を管理します。たとえば、State、API通信、検索処理、エラー処理を担当します。そして、表示用コンポーネントへPropsを渡します。
// データや処理を管理するコンポーネントのイメージです
function UserSearchContainer() {
// 検索語や取得結果などのStateを管理します
// APIを呼び出し、結果を表示用コンポーネントへ渡します
return (
<UserList users={users} />
);
}JSXこの分け方は「Containerは処理だけ、Presentationalは表示だけ」と厳密に守らなければならない決まりではありません。ひとつのコンポーネントが表示と処理の両方を持つこともあります。役割分担を考えるための目安として使いましょう。
4. 責務分離とは
責務分離とは、コンポーネントごとに担当する役割をはっきりさせることです。今回のアプリなら、次のように整理できます。
UserSearchContainer:検索State、API通信、検索結果の管理。UserSearchForm:検索語入力欄と検索ボタンの表示。SearchFeedback:読み込み中、エラー、検索結果なしの表示。UserList:ユーザー一覧の表示。UserCard:ユーザー1人分の表示。
ひとつのコンポーネントに表示、通信、入力チェック、一覧表示がすべて集まっていたら、役割の分割を検討するタイミングです。
5. ファイル構成を決める
今回の例では、次のようにファイルを分けます。
my-app/
├── app/
│ └── users/
│ └── page.js
└── components/
└── users/
├── UserSearchContainer.js
├── UserSearchForm.js
├── SearchFeedback.js
├── UserList.js
└── UserCard.js
srcフォルダーを使っている場合は、appとcomponentsをsrcの中に置く構成でも問題ありません。大切なのは、プロジェクト内で分かりやすく一貫した配置にすることです。
6. まずはページからContainerを呼び出す
app/users/page.jsを作ります。ページ自体は静的な役割にし、操作やStateを使うContainerに処理をまとめます。
// ユーザー検索を管理するClient Componentを読み込みます
import UserSearchContainer from "../../components/users/UserSearchContainer.js";
// /usersページを表示します
export default function UsersPage() {
return (
<main>
<h1>ユーザー検索</h1>
<p>名前を入力してサンプルユーザーを検索します。</p>
{/* 検索のStateやAPI通信はContainerに任せます */}
<UserSearchContainer />
</main>
);
}JSXUserSearchContainerがuseStateやイベント処理を担当するため、このページファイル自体には'use client'を付けていません。Next.jsでは、クライアント側で動かす必要がある部分をClient Componentにできます。境界を必要以上にページ全体へ広げないようにすると、構成を整理しやすくなります。(🔗 nextjs.org)
7. 検索フォームを作る
components/users/UserSearchForm.jsを作ります。このコンポーネントは、入力欄とボタンを表示します。入力内容のStateや実際の検索処理は親からPropsとして受け取ります。
// 検索欄とボタンを表示するコンポーネントです
export default function UserSearchForm({
query,
isLoading,
onQueryChange,
onSubmit,
}) {
return (
// フォーム送信の処理は親から受け取ります
<form onSubmit={onSubmit}>
<label htmlFor="user-search">検索する名前</label>
<input
id="user-search"
type="search"
value={query}
maxLength={80}
placeholder="例:Emily"
// 入力された文字列を親へ伝えます
onChange={(event) => onQueryChange(event.target.value)}
/>
<button type="submit" disabled={isLoading}>
{isLoading ? "検索中..." : "検索"}
</button>
</form>
);
}JSXこのコンポーネントは、検索APIのURLや通信エラーを知りません。親から受け取ったqueryを表示し、入力やフォーム送信を親へ伝えるだけです。これが表示側の責務を絞る一例です。
8. 状態メッセージを作る
components/users/SearchFeedback.jsを作り、ローディング中、エラー、検索結果なしの表示をまとめます。
// 検索の状態に応じて案内を表示します
export default function SearchFeedback({
isLoading,
error,
hasSearched,
hasResults,
}) {
// 通信中の案内を表示します
if (isLoading) {
return <p aria-live="polite">ユーザーを検索しています...</p>;
}
// エラーがある場合はエラーメッセージを表示します
if (error) {
return <p role="alert">{error}</p>;
}
// 検索済みで結果がなければ案内を表示します
if (hasSearched && !hasResults) {
return <p>該当するユーザーは見つかりませんでした。</p>;
}
// まだ表示するメッセージがない場合は何も表示しません
return null;
}JSX条件ごとの表示をひとつにまとめると、ContainerのJSXを読みやすくできます。また、エラー表示の見た目を変えたいときに、修正する場所も分かりやすくなります。
9. ユーザーカードを作る
components/users/UserCard.jsを作り、ユーザー1人分の情報を表示します。
// ユーザー1人分のプロフィールを表示します
export default function UserCard({ user }) {
return (
<article>
<h3>
{user.firstName} {user.lastName}
</h3>
{/* emailがある場合だけ表示します */}
{user.email && <p>メール:{user.email}</p>}
{/* 会社名がある場合だけ表示します */}
{user.company?.name && (
<p>会社:{user.company.name}</p>
)}
</article>
);
}JSXuser.company?.nameは、companyが存在しない場合にもエラーになりにくいように、オプショナルチェーンを使っています。APIから来るデータは、常に全項目が存在するとは限りません。
10. ユーザー一覧を作る
components/users/UserList.jsを作ります。配列をmap()でカードに変換し、各項目に安定したkeyを指定します。
// UserCardコンポーネントを読み込みます
import UserCard from "./UserCard.js";
// 複数ユーザーの一覧を表示します
export default function UserList({ users, total }) {
// ユーザーがいないときは一覧を表示しません
if (users.length === 0) {
return null;
}
return (
<section aria-labelledby="user-list-heading">
<h2 id="user-list-heading">検索結果</h2>
<p>該当:{total}件(最大10件を表示)</p>
<ul>
{users.map((user) => (
// APIから受け取ったIDを一覧項目のkeyにします
<li key={user.id}>
{/* 1人分の表示はUserCardに任せます */}
<UserCard user={user} />
</li>
))}
</ul>
</section>
);
}JSX一覧の中でkeyを使うのは、Reactが項目を識別するためです。keyはUserCardのPropsとして自動的に渡される値ではありません。カード側でもIDを使いたい場合は、userの一部として渡すか、別のPropsとして明示します。(🔗 react.dev)
11. ContainerでStateとAPI通信を管理する
components/users/UserSearchContainer.jsに、検索の処理をまとめます。このコンポーネントが各表示コンポーネントへ必要なPropsを渡します。
// このファイルをClient Componentとして扱います
"use client";
// ReactのState、Effect、Refを読み込みます
import { useEffect, useRef, useState } from "react";
// 表示を担当するコンポーネントを読み込みます
import UserSearchForm from "./UserSearchForm.js";
import SearchFeedback from "./SearchFeedback.js";
import UserList from "./UserList.js";
// 検索StateとAPI通信を管理します
export default function UserSearchContainer() {
// 検索欄の入力内容を管理します
const [query, setQuery] = useState("");
// APIから取得したユーザーを管理します
const [users, setUsers] = useState([]);
// APIが返した検索結果件数を管理します
const [total, setTotal] = useState(0);
// 通信中かどうかを管理します
const [isLoading, setIsLoading] = useState(false);
// エラーメッセージを管理します
const [error, setError] = useState("");
// 検索が実行されたかどうかを管理します
const [hasSearched, setHasSearched] = useState(false);
// 現在の通信を中断するための参照です
const controllerRef = useRef(null);
// Containerが画面から外れるときに通信を中断します
useEffect(() => {
// cleanup関数を返します
return () => {
// 実行中の通信があれば中断します
controllerRef.current?.abort();
};
}, []);
// フォーム送信時にAPI検索を行います
async function handleSubmit(event) {
// ブラウザー標準のフォーム送信を止めます
event.preventDefault();
// 入力前後の空白を取り除きます
const trimmedQuery = query.trim();
// 空の検索語は送信しません
if (trimmedQuery === "") {
setError("検索する名前を入力してください。");
setUsers([]);
setTotal(0);
setHasSearched(false);
return;
}
// 前回の検索が残っていれば中断します
controllerRef.current?.abort();
// 今回の通信を管理するコントローラーを作ります
const controller = new AbortController();
// cleanupや次回検索で使えるように保存します
controllerRef.current = controller;
// 新しい検索を始める前に表示状態を整えます
setIsLoading(true);
setError("");
setUsers([]);
setTotal(0);
setHasSearched(true);
try {
// 検索語と必要なデータ項目をURLパラメーターにします
const params = new URLSearchParams({
q: trimmedQuery,
limit: "10",
select: "id,firstName,lastName,email,company",
});
// ユーザー検索APIにリクエストを送ります
const response = await fetch(
`https://dummyjson.com/users/search?${params.toString()}`,
{
// 前回検索や画面終了時に中断できるようにします
signal: controller.signal,
}
);
// HTTP応答が成功か確認します
if (!response.ok) {
throw new Error(`HTTPエラー:${response.status}`);
}
// JSONの応答をJavaScriptのデータに変換します
const data = await response.json();
// usersが配列であることを確認します
if (!Array.isArray(data.users)) {
throw new Error("APIから想定外のデータが返されました。");
}
// 今回の通信がまだ有効な場合だけ結果を反映します
if (!controller.signal.aborted) {
setUsers(data.users);
// totalが数値でなければ配列の件数を使います
setTotal(
Number.isFinite(data.total) ? data.total : data.users.length
);
}
} catch (requestError) {
// 通信中断は通常のエラー表示にしません
if (requestError.name === "AbortError") {
return;
}
// それ以外のエラーを画面用メッセージにします
setError("ユーザーを取得できませんでした。時間をおいて再度お試しください。");
} finally {
// この通信が現在の通信である場合だけ読み込みを終了します
if (controllerRef.current === controller) {
setIsLoading(false);
controllerRef.current = null;
}
}
}
return (
<section>
{/* 入力と送信はフォームコンポーネントに任せます */}
<UserSearchForm
query={query}
isLoading={isLoading}
onQueryChange={setQuery}
onSubmit={handleSubmit}
/>
{/* 状態に応じた案内を表示します */}
<SearchFeedback
isLoading={isLoading}
error={error}
hasSearched={hasSearched}
hasResults={users.length > 0}
/>
{/* 取得したユーザー一覧を表示します */}
{!isLoading && error === "" && (
<UserList users={users} total={total} />
)}
</section>
);
}JSXこのContainerにはStateやAPI通信がありますが、ユーザー情報のカードのHTMLやフォームの見た目は含めていません。処理の流れを担当し、表示の細部を子コンポーネントに任せています。
12. Propsを設計する
Propsは、親から子へ必要な情報を渡すための窓口です。Propsの名前から用途が分かり、必要なものだけを受け取れるようにしましょう。
今回のPropsは次のように整理できます。
| コンポーネント | Props | 役割 |
|---|---|---|
UserSearchForm | query、isLoading | 入力値と送信状態を表示します |
UserSearchForm | onQueryChange、onSubmit | 入力変更と送信を親へ伝えます |
SearchFeedback | isLoading、error、hasSearched、hasResults | 状態メッセージを切り替えます |
UserList | users、total | 一覧と件数を表示します |
UserCard | user | 1人分の情報を表示します |
イベント用のPropsには、onから始まる名前を付けることがあります。たとえばonSubmitやonQueryChangeです。値を渡すPropsとイベントを渡すPropsが見分けやすくなります。
13. 親から子、子から親への情報の流れ
Reactでは、データは基本的に親から子へPropsとして渡します。子コンポーネント内で起きた操作を親に知らせたい場合は、親から渡された関数を呼び出します。
// 親は現在の値と更新用関数を子へ渡します
<SearchForm
query={query}
onQueryChange={setQuery}
/>JSX// 子は入力値を変更したとき、親から受け取った関数を呼びます
<input
value={query}
onChange={(event) => onQueryChange(event.target.value)}
/>JSXデータは親から子へ、操作の通知は子から親へ関数を通じて伝わります。子が親のStateを直接変更するのではなく、親から渡された関数を呼ぶのが基本です。
14. 分割するかどうかを決める目安
すべての要素を別ファイルにする必要はありません。次のような場合は、分割すると役立つことがあります。
- ひとつのコンポーネントに複数の独立した役割が集まっている。
- 同じ表示部品を複数の場所で使う予定がある。
- 特定の部分だけを独立して読みやすく、テストしやすくしたい。
- 変更の影響範囲を狭くしたい。
逆に、数行しかなく、再利用も独立した役割もない部分まで細かく分けると、ファイル間の移動やPropsの受け渡しが増えて、かえって追いづらくなることがあります。
「小さく分ければ必ずよい」ではありません。コードを読む人が役割を把握しやすくなる分け方を選びます。
15. よくあるつまずき
- 分割したのに子コンポーネントが親のStateに直接アクセスしようとする:必要な値や関数をPropsで渡します。
- Propsが何十個にもなる:コンポーネントの責務が広すぎないか、Propsを用途ごとに整理できないか考えます。
- 表示用コンポーネントでAPI通信を始める:その処理をどこが担当するか決め、責務が混ざっていないか確認します。
- 細かく分けすぎる:独立した役割や再利用の必要があるかを基準にします。
- `key`を子コンポーネント内で使おうとする:`key`はReactが一覧を識別するための値です。子でも必要なら別のPropsとして渡します。
- Client Componentの範囲を必要以上に広げる:Stateやイベントが必要な部分を中心にクライアント側へ分けます。
16. Day 23のチェックリスト
- 表示を担当するコンポーネントと、データ・処理を管理するコンポーネントの違いを説明できます。
- コンポーネントごとの役割をひとつの短い文で説明できます。
- Propsで値を親から子へ渡せます。
- 親から渡された関数で、子から親へ操作を伝えられます。
- API通信やState管理を、表示部分から分けて整理できます。
- コンポーネントを分割しすぎない判断基準を持てます。
- Next.jsでClient Componentが必要な範囲を意識できます。
コンポーネント設計では、まず大きな画面の役割を分け、次に各部品へ必要なPropsだけを渡します。今回のユーザー検索アプリでは、検索処理をUserSearchContainerにまとめ、フォーム、状態メッセージ、一覧、カードをそれぞれ独立させました。この構成を出発点に、画面の大きさや再利用の必要性に応じて、分割の粒度を調整しましょう。
