2026年1月17日

コンポーネント駆動開発(Component-Driven Development: CDD)

CDDとは

  • コンポーネント駆動開発(Component-Driven Development: CDD)
    • 「最小単位の部品(コンポーネント)」から構築を始め、それらをパズルのように組み合わせて最終的なページを完成させる「ボトムアップ」方式の設計手法

CDDのメリットとデメリット

  • CDDの導入には、開発の効率化と品質向上に寄与する多くの利点がありますが、一方でコスト面での課題も存在します。

メリット

  • 品質と耐久性の向上: コンポーネントを個別に分離して構築するため、動作を独立してテストでき、バグの特定が容易になります
  • 開発スピードの加速: 一度作成した部品は他の画面でも再利用できるため、新しいページを構築する際の工数を削減できます
  • 効率的なチーム開発: UIを個別の部品に分解することで、メンバー間で作業を分担しやすくなり、デザイナーと開発者の並行作業もスムーズになります
  • 生きたドキュメント: Storybookなどのツールを使用することで、コンポーネントの全バリエーションが視覚化され、そのまま仕様書やドキュメントとして機能します

デメリット

  • オーバーキル: 規模の小さいプロジェクトでは、すべての要素を最小単位から定義することは過剰な工数となり、複雑さを増す可能性があります。
  • モックデータの準備: コンポーネントのあらゆる状態を再現するために、大量のモックデータやダミー関数を準備する手間がかかります。
  • 管理コスト: ツールの初期設定や、増え続けるストーリー(コンポーネントの状態定義)の管理に一定の労力が必要です。

CDDを用いたテスト

  • CDDでは、コンポーネントがアプリケーション全体のロジックから切り離されているため、独立した環境での高度なテストが可能です。

  • 単体テスト(レンダリングテスト): 特定のプロパティ(props)を渡した際に、コンポーネントが正しく表示されるかを確認します。

  • インタラクションテスト: Storybookの「play関数」などを用いて、クリックや入力といったユーザーの操作をシミュレートし、DOM構造の変化や関数の呼び出しを検証します。

  • ビジュアルリグレッションテスト(VRT): Chromaticなどのツールを使用し、変更前後のスクリーンショットを比較して、意図しないデザインの崩れを自動で検知します。

  • アクセシビリティテスト: コンポーネント単位で、スクリーンリーダー対応などのアクセシビリティ要件を満たしているかチェックします

具体的な開発の中で行う方法

  • 実際のフロントエンド開発フローでは、以下のようなステップでCDDを実践します。
  1. 最小単位(アトム)の構築 まず、ボタンや入力欄といった最も細かいレベルのコンポーネントを、**アプリケーションのビジネスロジックから切り離された独立した環境(Storybook)**で作成します。 • 具体例: MyButton コンポーネントの作成。 • Storybookでの定義: コンポーネントの「状態」(プライマリ、セカンダリ、サイズ違いなど)を「ストーリー」として定義します。これにより、開発者はブラウザ上で全バリエーションを視覚的に確認しながら開発を進められます。

  2. 複合コンポーネント(分子・有機体)への結合 作成した最小単位を組み合わせて、より複雑な機能を持つコンポーネントを構築します。 • 具体例: MyButton を組み込んだ UserForm(入力画面)の作成。 • 開発の進め方: ページ全体を作る前に、まずStorybook上でこのフォームが「初期表示」「エラー表示」「データ送信時」にどのようになるかを個別に設計・テストします。

  3. インタラクションテストの実施 コンポーネントが複雑になり、ユーザーの操作が伴う場合は、**Storybookの「play関数」**を使用して、ブラウザ上での挙動をシミュレーションし、テストを行います。 • 具体例: ログインフォーム(LoginForm)にメールアドレスとパスワードを入力し、ボタンをクリックした後に「アカウント準備完了」というテキストが表示されるかを自動で検証します。 • メリット: 実際のブラウザ環境でテストが実行されるため、DOM構造や関数の呼び出しを視覚的にデバッグしながら確認できます。

  4. ビジュアルリグレッションテスト(VRT)の導入 UIの崩れを自動で検知するために、Chromatic などのツールを使用して、見た目の差分チェックをフローに組み込みます。 • 具体的な動作: コードを変更してプッシュするたびに、コンポーネントのスナップショットを撮影し、以前のバージョンと比較します。 • 自動化: GitHub ActionsなどのCIツールと連携させることで、プルリクエスト時に自動でUIの変更箇所を抽出し、人間の目でレビューできるようにします。

  5. 最終的なページへの組み込み 十分にテストされ、ドキュメント化されたコンポーネントを組み合わせて、最終的な「ページ」を完成させます。 • メリット: 既に個別の部品の品質が保証されているため、ページ構築時のバグが減り、開発スピードが大幅に向上します。また、一度作ったコンポーネントは他の画面でも容易に再利用可能です

まとめ:CDD開発フローのイメージ

  1. アトム(ボタン等)を作る: Storybookで見た目と状態を定義。
  2. 分子・有機体(フォーム等)に組む: 複数の部品を結合し、特定のUIシナリオを構築。
  3. 挙動をテストする: play関数でユーザー操作をシミュレート。
  4. 見た目を保護する: Chromatic等で意図しないUI変更を監視。
  5. ページ化する: 完成した部品をページに配置