😺

Presentational / Containerパターンについて改めて考える

に公開

はじめに

みなさま、お疲れ様です。
今年の11月、 Linc'well にFEエンジニアとして入社した、yojiです。

今回は、プロジェクト参画に対して良いなと思った文化について個人的に考えてみた記事を投稿します。

導入

入社してタスクを実施する中で、プロジェクト全体のコーディング指針として「Presentational/Containerパターン」が採用されていました。

名前は以前より認知していましたが真剣に記述したことがなかったので、プロダクトのコードを理解しつつ、Presentational/Containerパターンを勉強しました。

この記事は、その過程で学んだ内容を整理し、実装に際して考えたことを個人的な主観をまとめた記事です。

記事の対象と狙い

この記事は、以下のような方を対象としています。

  • Presentational/Containerパターンを名前だけは知っているが、具体的な実装やメリットを理解していない方
  • Presentational/Containerパターンの意義や目指す先を考えたい人

この記事では、Presentational/Containerパターンの本質的な概念と実践方法に焦点を当てるため、以下のトピックについては言及しません。

  • 特定の状態管理ライブラリ: ReduxやZustandなど、特定のライブラリに特化した実装や詳細な連携方法
  • パフォーマンス最適化: React.memoやuseCallbackの応用など、パフォーマンスチューニングに関する深い議論
  • テストや型の高度なテクニック: Vitestなどを用いた具体的なテストコードの実装や、TypeScriptの複雑な型定義
  • 他の設計パターンとの詳細な比較: Compound Componentsなど、他のUI設計パターンとの網羅的な比較分析
  • 自社プロダクトについて: 自社のプロダクトに対してどれだけ法則を適用できているか、どれだけ健全かなどは論じず、意図を一切含みません

Presentational/Containerパターンとは

前提:「関心の分離」と「機能的凝集」

ソフトウェアにおいて遵守したい品質特性や設計概念として、以下のキーワードがあります。

  • 関心の分離:異なる目的や役割を持つものを混ぜず、独立した部品として整理する設計原則・手法
    • 例:自動車で「エンジン(動力)」と「ハンドル(操作)」を分ける
  • 機能的凝集:各コンポーネントが単一の明確な責務のみを持つ状態(達成される品質状態)

関心の分離を実践すると、結果として機能的凝集が達成されます。
この状態により、コードの可読性・再利用性・保守性・テスト容易性が向上し、開発生産性が向上します。

Presentational/Containerパターンとは?

UI(見た目)とロジック(機能)の関心を分離するための設計パターンです。

このパターンは、コンポーネントを2種類に分けて役割を明確にします:

  • Presentational Component:見た目(表示)に責任を持つ → UI表示という単一機能に特化
  • Container Component:機能(ロジック)に責任を持つ → データ取得・状態管理という単一機能に特化

データとイベントの流れは以下のイメージです。

Presentational Component:見た目に責任を持つ

役割

  • データの表示
  • UIイベントを親コンポーネントに通知(コールバック関数の実行)

特徴

原著では、Presentational Componentは以下のように定義されています。

  • 「どのように見えるか(how things look)」に関心を持つ
  • 通常はDOMマークアップとスタイルのみを持つ
  • データやその変更処理は、すべてpropsとして親から受け取る
  • UIに関するごくわずかな状態を除き、自身の状態(state)を持たない
  • データの読み込みや変更は行わず、アプリケーションの他の部分(Fluxアクション、ストアなど)に依存しない
  • 関数コンポーネントとして実装される
  • 内部に他のPresentationalコンポーネントを含むことが一般的(例:CommentListが複数のCommentItemを含む)

コード例

// Presentational Component
interface UserCardProps {
  name: string;
  email: string;
  onEdit: () => void;
}

export const UserCard: React.FC<UserCardProps> = ({ name, email, onEdit }) => {
  return (
    <div className="user-card">
      <h2>{name}</h2>
      <p>{email}</p>
      <button onClick={onEdit}>編集</button>
    </div>
  );
};

このコンポーネントは、渡されたデータを表示し、ボタンが押されたらonEditを呼ぶだけです。
データがどこから来たのか、編集処理が何をするのかは知りません。

Container Component:機能に責任を持つ

役割

  • データ取得(API通信など)
  • 状態管理
  • ビジネスロジックの実行

特徴

原著では、Container Componentは以下のように定義されています。

  • 「どのように機能するか(how things work)」に関心を持つ
  • PresentationalコンポーネントやContainerコンポーネントをラップ(内包)する
  • Reduxなどの状態管理ライブラリと接続し、アクションをディスパッチしたり、ストアから状態を受け取る
  • 子コンポーネントに必要なデータや振る舞い(コールバック関数)をpropsとして渡す
  • 自身のスタイルを持つことはほとんどなく、HTMLの構造も<div>で囲む程度
  • クラスコンポーネントや高階コンポーネント(HOC)として実装される

コード例

// Container Component
import { useState, useEffect } from 'react';
import { UserCard } from './UserCard';

export const UserCardContainer: React.FC = () => {
  const [user, setUser] = useState({ name: '', email: '' });

  useEffect(() => {
    // データ取得
    fetch('/api/user')
      .then(res => res.json())
      .then(data => setUser(data));
  }, []);

  const handleEdit = () => {
    // 編集処理のロジック
    console.log('編集モードに移行');
  };

  return <UserCard name={user.name} email={user.email} onEdit={handleEdit} />;
};

このコンポーネントは、データ取得とロジックを担当し、表示はUserCardに任せています。

各Componentの命名

Presentational Componentには「Presentational.tsx」、Container Componentには「Container.tsx」という命名を行い、フォルダ名でそのコンポーネントの役割や対象を表現する命名パターンが多いです。

パターンの目的とメリット

パターンが目指すこと

このパターンの目的は 関心の分離を実現することです。
UIの関心事(見た目)とビジネスロジックの関心事(機能)を明確に分離し、それぞれが独立して進化できる構造を作ることができる状態を目指します。

得られるメリット

  1. 関心の分離による再利用性の向上

    • UIとロジックを分離することで、それぞれの再利用が容易になる
    • 同じ機能を持つContainerが、異なる見た目のPresentationalコンポーネントを切り替えて利用できる
  2. 開発効率の向上

    • Presentationalコンポーネントはアプリケーションのロジックから独立しているため、デザイナーやUI担当の開発者がアプリケーションの内部構造を気にせずUIの調整に集中できる
    • ダミーのpropsを渡すだけで、様々なUIのバリエーションを開発・確認できる
  3. 保守性・リファクタリングの容易さ

    • アプリケーションのロジックやデータソースが変更になった場合、修正は主にContainerコンポーネントに集中する
    • UI部分は変更せずに済むため、影響範囲を限定できる
    • 変更が及ぼす影響を予測しやすく、安全にリファクタリングできる

これらのメリットは、前述の「機能的凝集」の利点と密接に関連しています。
各コンポーネントが単一の明確な責務のみを持つため、再利用性・保守性・テスト容易性が自然と向上します。

Hooksによる実装パターン

React Hooksの登場に伴い、Containerコンポーネントのロジック部分をカスタムフックに切り出すパターンが主流になっています。

// カスタムフックにロジックを切り出す
const useUser = () => {
  const [user, setUser] = useState({ name: '', email: '' });

  useEffect(() => {
    fetch('/api/user')
      .then(res => res.json())
      .then(data => setUser(data));
  }, []);

  const handleEdit = () => {
    console.log('編集モードに移行');
  };

  return { user, handleEdit };
};

// Containerコンポーネントはフックを使用してPresentationalに渡すだけ
export const UserCardContainer: React.FC = () => {
  const { user, handleEdit } = useUser();
  return <UserCard name={user.name} email={user.email} onEdit={handleEdit} />;
};

この方法により、従来のPresentational/Containerの分離と同等の効果を、より柔軟に実現できます。

Presentational/Containerパターンの比較まとめ

ここまで解説したPresentational ComponentとContainer Componentの特徴を比較表で整理します。

観点 Presentational Component Container Component
主な関心事 UIの見た目(how things look) ロジック・機能(how things work)
責務 データの表示、UIイベントの通知 データ取得、状態管理、ビジネスロジック
状態(state) UIに関するごくわずかな状態のみ
(開閉状態、ホバーなど)
基本的には一つも持ちたくない
Containerが関心を持つ状態
(データ、モード、フラグなど)
データの受け取り方 すべてpropsから受け取る API、Redux、カスタムフックなどから取得
スタイル 持つ(CSS、styled-componentsなど) ほとんど持たない(<div>で囲む程度)
依存関係 アプリケーションのロジックに依存せず、表示用ロジックのみ 状態管理ライブラリ、APIなどに依存
実装方法 関数コンポーネント カスタムフック + 関数コンポーネント
テストのしやすさ 容易(propsを渡すだけ) やや複雑

実際に触って思ったこと

個人的に判断が難しかった実装パターン

実際にこのパターンに準拠する上で、いくつか悩むパターンがありました。

1. ローカルUI状態(例:開閉状態、ホバー状態)

例:ドロップダウンメニューの開閉状態

// この状態はどちらで管理する?
const [isOpen, setIsOpen] = useState(false);

判断基準としては、以下を考えています。

Presentational側で持つ場合

  • そのコンポーネントのUIにのみ関わる一時的な状態(開閉、ホバー、フォーカスなど)ならOK
    • UIに閉じた状態はそのコンポーネントの責務範囲内であり、再利用性を損なわないため

Container側で持つ場合

  • アプリケーションデータや、他のコンポーネントと共有される状態
// ✅ Presentationalコンポーネントで管理
export const DropdownMenu: React.FC<DropdownMenuProps> = ({ items, onSelect }) => {
  const [isOpen, setIsOpen] = useState(false);

  return (
    <div>
      <button onClick={() => setIsOpen(!isOpen)}>メニュー</button>
      {isOpen && <Menu items={items} onSelect={onSelect} />}
    </div>
  );
};

2. 条件分岐によるコンポーネント切り替え

例:編集モードと表示モードの切り替え

// ❓ この切り替えロジックはどちらで持つ?
{isEditMode ? <UserEditForm /> : <UserDisplay />}

判断基準としては、以下を考えています。

Container側で持つ場合

  • モードの切り替えがビジネスロジック(例:権限チェック、APIの状態)に依存する場合

Presentational側で持つ場合

  • 純粋にUIの表示切り替えのみの場合(ただし、Container側でisEditModeを渡す実装も存在する)
      1. のパターンに該当する
    • こちらになるケースは稀の認識
// ✅ 推奨:Container側でモード管理
export const UserCardContainer: React.FC = () => {
  const [isEditMode, setIsEditMode] = useState(false);
  const [user, setUser] = useState(null);

  return (
    <UserCard
      user={user}
      isEditMode={isEditMode}
      onEditToggle={() => setIsEditMode(!isEditMode)}
    />
  );
};

// Presentational側は受け取った状態で表示を切り替えるだけ
export const UserCard: React.FC<UserCardProps> = ({ user, isEditMode, onEditToggle }) => {
  return isEditMode ? (
    <UserEditForm user={user} />
  ) : (
    <UserDisplay user={user} onEdit={onEditToggle} />
  );
};

3. 表示用ロジックの扱い

文字列の省略や件数表示の切り替えなど、表示やデザインに関するロジックです。

例:

  • 配列の要素数に応じて「0件」「1件」「複数件」と表示を変える
  • 文字列の長さに応じて「...」で省略する
  • 入力値の残り文字数を表示する
  • エラーメッセージの表示/非表示を制御する
  • CSSクラス名を条件によって切り替える
// ✅ Presentational側で表示用ロジックを持つ
export const UserList: React.FC<{ users: User[] }> = ({ users }) => {
  // 表示用ロジック:件数による表示切り替え
  const getCountText = () => {
    if (users.length === 0) return '0件';
    if (users.length === 1) return '1件';
    return `${users.length}件`;
  };

  // 表示用ロジック:文字列の省略
  const truncate = (text: string, maxLength: number) => {
    return text.length > maxLength ? `${text.slice(0, maxLength)}...` : text;
  };

  return (
    <div>
      <h2>ユーザー一覧({getCountText()})</h2>
      <ul>
        {users.map(user => (
          <li key={user.id}>{truncate(user.name, 20)}</li>
        ))}
      </ul>
    </div>
  );
};

判断基準としては、以下を考えています。

表示用ロジックはPresentational Component側で持たせる。

  • UIの見た目に関する関心事であるため
  • 他のコンポーネントに影響を与えず、そのコンポーネントの責務(見た目の制御)の範囲内であるため

4. どこまで丁寧に分割するか

例:シンプルなボタンを無理に分割するケース

// ❌ 過度な分割:シンプルなボタンを無理に分割
// Container
export const SubmitButtonContainer: React.FC = () => {
  const handleClick = () => {
    console.log('送信');
  };
  return <SubmitButton onClick={handleClick} />;
};

// Presentational
export const SubmitButton: React.FC<{ onClick: () => void }> = ({ onClick }) => {
  return <button onClick={onClick}>送信</button>;
};

100%このデザインパターンを実現すべきかは判断に悩む部分です。
制約がないのであれば目指してもいいですが、基本的には実装コストや優先タスクとのバランスが大事だと思います。

判断基準としては以下を考えています。

分割しない方が良い場合

  • 複雑な構造になり得ないケース
    • 分割のメリットよりもファイル数増加のデメリットが上回るため
  • 分岐ロジックがほぼ挟まらず、複雑度が低い場合

分割した方が良い場合

  • 状態管理やAPI呼び出しがある(データフェッチやビジネスロジックをContainerに集約)
  • 複数箇所で再利用される(UIコンポーネントを様々な場所で使い回したい)
  • ビジネスロジックが含まれる(計算、バリデーション、権限判定などのロジックがある)

個人的に難しいと思っている点

  • コンポーネント数の増加
     1つの機能に対して2つのコンポーネントが必要になり、ファイル数が増えます。

  • コードの冗長性
     propsのバケツリレー(props drilling)が発生しやすくなります。
     これによって情報の追跡や出所の調査に困ったりもしました。

    // 何段にもpropsを渡すことになる
    <ContainerA>
      <ContainerB data={data}>
        <PresentationalC data={data}>
          <PresentationalD data={data} />
        </PresentationalC>
      </ContainerB>
    </ContainerA>
    
  • 命名の難しさ
     単に「Presentational.tsx」「Container.tsx」だったりすると、ファイル検索の時に困ることがありました。

  • 分割基準の統一
     (このパターンだけの問題ではないと思いますが、)書き手によっては微妙に分割判断が分かれると思います。

個人的に良いと思っている点

  • 関心の分離を自然に実現できるパターンである
    • コンポーネントの責務が明確になり、コードが読みやすい
    • 実装や修正する際、迷子になりにくい
  • ファイルの見通しやコンポーネントの変更理由を単一にできる
  • 認識統一のための標語として使いやすい
    • チームや会社全体での標語として扱うことができる
    • AIも結構理解しているようで、指示出しにも使える

実装にあたって工夫したい点

  • とにかく、UIロジックとビジネスロジックの責務を分けることを意識する
  • 同時に、機能的凝集が達成できるかは注意する
  • 完璧は目指さない方が良い
    • 実装速度やcomponentの関心を考えて、時にはパターンの適用をやらないことも選択肢だと思う
  • ファイル名を区別、検索しやすくする
    • 単に「Presentational.tsx」「Container.tsx」だと探しにくかったりする
  • ファイルの大きさや粒度に気をつける
    • コード行が多くなっているときは、もしかしたら取り扱っている単位が大きすぎるかもしれないことを考える
    • 個人差が出るポイントなので、チーム内で相談すること

まとめ

個人的な学びは以下です。

  • Presentational/Containerパターンは「関心の分離」を実現するための手段の一つ
  • 実戦の中で、ビジネスロジックかどうかはかなり意識する機会になった
  • Container コンポーネント自体はHooksで代用可能、ただしHooksの膨らみすぎには注意
  • 分割単位には注意したい。区切りすぎると却って扱いにくかったり、工数が増えたりしてしまう

Next Action

今後、以下のアクションを進めていきたいです。

  • チーム内での議論

    • 学びの共有と議論をチームで実施
    • このパターンの判断基準をチームでドキュメント化
  • 実践の継続

    • 新規コンポーネントでこのパターンを意識して設計
    • 小さな単位から徐々にリファクタリングを試す
  • 他パターンの実装や最新Reactとの親和性の検討

    • React v19のServer ComponentsやActionsとの関係性をさらに理解する
    • 他のデザインパターンの研究する

参考文献

Linc'well, inc.

Discussion