Next.jsで学ぶReact講座 90日コース | React基礎 - Day 23:コンポーネント設計

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

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>
  );
}
JSX

3. 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>
  );
}
JSX

UserSearchContainerが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>
  );
}
JSX

user.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役割
UserSearchFormquery、isLoading入力値と送信状態を表示します
UserSearchFormonQueryChange、onSubmit入力変更と送信を親へ伝えます
SearchFeedbackisLoading、error、hasSearched、hasResults状態メッセージを切り替えます
UserListusers、total一覧と件数を表示します
UserCarduser1人分の情報を表示します

イベント用の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にまとめ、フォーム、状態メッセージ、一覧、カードをそれぞれ独立させました。この構成を出発点に、画面の大きさや再利用の必要性に応じて、分割の粒度を調整しましょう。

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