ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

ReactおよびVueプロジェクトにおけるアトミックデザインの実装

Jul 25, 2025
# Misc

Daniel Hayes

Full-Stack Engineer · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "ReactおよびVueプロジェクトにおけるアトミックデザインの実装"

はじめに：スケーラブルなフロントエンドインターフェイスのアーキテクチャ

フロントエンド開発の急速に進化する状況において、保守可能でスケーラブルなユーザーインターフェイスを構築することは最重要です。プロジェクトが複雑化するにつれて、増え続けるコンポーネントライブラリの管理は大きな課題となり、一貫性のなさ、冗長性、そして絡み合ったコードベースにつながる可能性があります。ここで、UI開発への構造化されたアプローチが不可欠になります。Brad Frostによって考案された方法論であるアトミックデザインは、インターフェイスを基本的な構成要素に分解し、階層的に再構築するための強力なフレームワークを提供します。その中核的な哲学は、UI構築のための明確なメンタルモデルと体系的なワークフローを促進することにより、大規模なコンポーネント管理のペインポイントに直接対処します。アトミックデザインを採用することにより、フロントエンドチームは、より高い一貫性、改善されたコラボレーション、高速化された開発サイクルを促進し、最終的にはより高品質なユーザーエクスペリエンスを提供できます。この記事では、ReactやVueのようなモダンなコンポーネントベースのフレームワーク内でのアトミックデザイン原則の実用的なアプリケーションを掘り下げ、より整理された効率的な開発プロセスのためにそれらの強みを活用する方法を実証します。

アトミックデザインの構成要素を理解する

実装の詳細に入る前に、アトミックデザインの核となる概念を理解することが重要です。この方法論は、単純なものから複雑なものへと自然界の進行を模倣して、デザインシステムを5つの明確な段階に分解します。

アトム

アトムは、すべての物質の基本的な構成要素であり、したがって、私たちのインターフェイスの構成要素です。それらは、意味や機能を失うことなくさらに分解できない、インターフェイスの最小の独立した単位です。フロントエンドのコンテキストでは、これは通常、HTMLタグ、基本的なUI要素、またはグローバルスタイルの定義に変換されます。

例：

  • ボタン
  • 入力フィールド
  • ラベル
  • アイコン
  • 見出し
  • テキストブロック
// React Atom: Button
function Button({ type = 'button', onClick, children, ...props }) {
  return (
    <button type={type} onClick={onClick} {...props}>
      {children}
    </button>
  );
}

// Vue Atom: InputField
<template>
  <input :type="type" :value="modelValue" @input="$emit('update:modelValue', $event.target.value)" />
</template>

<script>
export default {
  props: {
    type: {
      type: String,
      default: 'text'
    },
    modelValue: String
  }
};
</script>

分子

分子は、比較的小さく、しかし機能的なUIコンポーネントを形成するために結合されたアトムのグループです。それらは、アトムを小さく再利用可能な単位に組み合わせ、特定の機能と一貫した意味論的意味を追加します。

例：

  • 検索フォーム（入力フィールド、ボタン、ラベルで構成）
  • ナビゲーションアイテム（リンクとアイコンで構成）
// React Molecule: SearchForm
import Button from './Button'; // Assuming Button is an Atom
import InputField from './InputField'; // Assuming InputField is an Atom

function SearchForm({ onSubmit, ...props }) {
  const [searchTerm, setSearchTerm] = useState('');

  const handleSubmit = (e) => {
    e.preventDefault();
    onSubmit(searchTerm);
  };

  return (
    <form onSubmit={handleSubmit} {...props}>
      <InputField
        type="search"
        placeholder="Search..."
        value={searchTerm}
        onChange={(e) => setSearchTerm(e.target.value)}
      />
      <Button type="submit">Search</Button>
    </form>
  );
}

// Vue Molecule: UserProfileHeader
<template>
  <div class="user-profile-header">
    <Avatar :src="user.avatar" /> <!-- Avatar is an Atom -->
    <Heading level="2">{{ user.name }}</Heading> <!-- Heading is an Atom -->
    <Button @click="editProfile">Edit</Button> <!-- Button is an Atom -->
  </div>
</template>

<script>
import Avatar from '../atoms/Avatar.vue';
import Heading from '../atoms/Heading.vue';
import Button from '../atoms/Button.vue';

export default {
  components: { Avatar, Heading, Button },
  props: {
    user: Object
  },
  methods: {
    editProfile() {
      console.log('Edit profile clicked');
    }
  }
};
</script>

オルガニズム

オルガニズムは、インターフェイスの特定の部分を形成するために連携する分子および/またはアトムのグループで構成される、比較的小さなUIコンポーネントです。それらは分子よりも精巧であり、多くの場合、ページの完全で独立したセクションを表します。

例：

  • ヘッダー（ロゴ、ナビゲーションリンク、検索フォームで構成）
  • 商品カード（画像、タイトル、価格、カート追加ボタンで構成）
// React Organism: SiteHeader
import Logo from '../atoms/Logo';
import NavLink from '../molecules/NavLink'; // Assuming NavLink is a Molecule
import SearchForm from '../molecules/SearchForm';

function SiteHeader({ onSearch }) {
  return (
    <header className="site-header">
      <Logo />
      <nav>
        <NavLink to="/">Home</NavLink>
        <NavLink to="/products">Products</NavLink>
        <NavLink to="/about">About</NavLink>
      </nav>
      <SearchForm onSubmit={onSearch} />
    </header>
  );
}

// Vue Organism: ProductGridItem
<template>
  <div class="product-grid-item">
    <ProductImage :src="product.imageUrl" :alt="product.name" />
    <ProductInfo :name="product.name" :price="product.price" /> <!-- ProductInfo is a Molecule -->
    <AddToCartButton :productId="product.id" /> <!-- AddToCartButton is an Atom or Molecule -->
  </div>
</template>

<script>
import ProductImage from '../atoms/ProductImage.vue';
import ProductInfo from '../molecules/ProductInfo.vue';
import AddToCartButton from '../atoms/AddToCartButton.vue'; // Or a more complex molecule

export default {
  components: { ProductImage, ProductInfo, AddToCartButton },
  props: {
    product: Object
  }
};
</script>

テンプレート

テンプレートは、オルガニズムをレイアウトに配置するページレベルのオブジェクトです。それらは、実際のデータを抽象化して、コンテンツ構造とレイアウトのみに焦点を当てます。テンプレートは、実際のデータでそれらを埋め込むことなく、ページ上のコンポーネントの配置を定義します。

例：

  • 商品詳細ページテンプレート（商品画像、説明、関連商品オルガニズムが配置される場所を示す）
  • ブログ記事ページテンプレート（記事コンテンツ、著者情報、コメントセクションを示す）
// React Template: ProductDetailPageTemplate
import SiteHeader from '../organisms/SiteHeader';
import ProductDisplay from '../organisms/ProductDisplay'; // An organism for detailed product view
import RelatedProducts from '../organisms/RelatedProducts';
import SiteFooter from '../organisms/SiteFooter';

function ProductDetailPageTemplate({ productData, relatedProductsData }) {
  return (
    <div className="product-detail-template">
      <SiteHeader onSearch={() => console.log('Searching...')} />
      <main>
        <ProductDisplay product={productData} />
        <RelatedProducts products={relatedProductsData} />
      </main>
      <SiteFooter />
    </div>
  );
}

// Vue Template: BlogArticlePageTemplate
<template>
  <div class="blog-article-template">
    <AppHeader /> <!-- AppHeader is an Organism -->
    <main>
      <ArticleHero :title="article.title" :author="article.author" /> <!-- Organism -->
      <ArticleContent :blocks="article.contentBlocks" /> <!-- Organism -->
      <CommentsSection :comments="article.comments" /> <!-- Organism -->
    </main>
    <AppFooter /> <!-- AppFooter is an Organism -->
  </div>
</template>

<script>
import AppHeader from '../organisms/AppHeader.vue';
import ArticleHero from '../organisms/ArticleHero.vue';
import ArticleContent from '../organisms/ArticleContent.vue';
import CommentsSection from '../organisms/CommentsSection.vue';
import AppFooter from '../organisms/AppFooter.vue';

export default {
  components: { AppHeader, ArticleHero, ArticleContent, CommentsSection, AppFooter },
  props: {
    article: Object // Expects an object with title, author, contentBlocks, comments etc.
  }
};
</script>

ページ

ページは、テンプレートを実際のコンテンツで埋め込んだ特定のインスタンスです。それらは、ユーザーが対話する最終的にレンダリングされたUIを表します。この段階で、コンポーネントはAPIまたは他のソースから取得した実際のデータを受け取ります。

例：

  • すべてのコンテンツを含む実際の「私たちについて」ページ
  • 特定の製品の動的にロードされた製品詳細ページ
// React Page: ProductDetailPage (actual instance)
import ProductDetailPageTemplate from '../templates/ProductDetailPageTemplate';
import { fetchProduct, fetchRelatedProducts } from '../../api'; // Mock API calls
import { useState, useEffect } from 'react';

function ProductDetailPage({ productId }) {
  const [product, setProduct] = useState(null);
  const [relatedProducts, setRelatedProducts] = useState([]);

  useEffect(() => {
    // Simulate fetching data
    fetchProduct(productId).then(setProduct);
    fetchRelatedProducts(productId).then(setRelatedProducts);
  }, [productId]);

  if (!product) {
    return <div>Loading product...</div>;
  }

  return (
    <ProductDetailPageTemplate
      productData={product}
      relatedProductsData={relatedProducts}
    />
  );
}

// Vue Page: BlogArticlePage (actual instance)
<template>
  <BlogArticlePageTemplate v-if="article" :article="article" />
  <div v-else>Loading article...</div>
</template>

<script>
import BlogArticlePageTemplate from '../templates/BlogArticlePageTemplate.vue';
import { getArticleById } from '../../api'; // Mock API call

export default {
  components: { BlogArticlePageTemplate },
  data() {
    return {
      article: null
    };
  },
  async created() {
    const articleId = this.$route.params.id; // Assuming Vue Router
    this.article = await getArticleById(articleId);
  }
};
</script>

ReactおよびVueでのアトミックデザインの実装

ReactとVueはどちらもコンポーネントベースのフレームワークであり、アトミックデザインに本質的に適しています。コンポーネントの階層構造は、アトムからページへの進行に完全に一致します。

プロジェクト構造

プロジェクトディレクトリを構造化するための一般的で効果的な方法は、アトミックデザインのステージをミラーリングすることです。

src/
├── components/
│   ├── atoms/
│   │   ├── Button.jsx  / Button.vue
│   │   ├── InputField.jsx / InputField.vue
│   │   └── ...
│   ├── molecules/
│   │   ├── SearchForm.jsx / SearchForm.vue
│   │   ├── NavLink.jsx / NavLink.vue
│   │   └── ...
│   ├── organisms/
│   │   ├── SiteHeader.jsx / SiteHeader.vue
│   │   ├── ProductDisplay.jsx / ProductDisplay.vue
│   │   └── ...
├── templates/
│   ├── ProductDetailPageTemplate.jsx / ProductDetailPageTemplate.vue
│   ├── BlogArticlePageTemplate.jsx / BlogArticlePageTemplate.vue
│   └── ...
├── pages/
│   ├── ProductDetailPage.jsx / ProductDetailPage.vue
│   ├── AboutPage.jsx / AboutPage.vue
│   └── ...
├── App.jsx / App.vue
└── main.js / main.ts

ReactおよびVueのベストプラクティス

  1. **コンポーネント命名：**アトミックデザインのステージを反映した、明確で簡潔で一貫した命名規則を維持します（例：アトムの場合は Button、分子の場合は SearchForm、オルガニズムの場合は SiteHeader）。
  2. **プロパードリリング対コンテキスト/Vuex/Pinia：**複雑なアプリケーションでは、オルガニズムとテンプレートでのプロパードリリングの管理が煩雑になる可能性があります。グローバルステート管理には、React Context API、Redux/Zustand、またはVuex/Piniaを検討してください。特にオルガニズムおよびテンプレートレベルでは、必要に応じてデータを注入するためです。ただし、アトムと分子は、プロップを介してデータを受け取る「ダム」な状態に保つようにしてください。
  3. **スタイリング：**アトミックデザインは、さまざまなスタイリングアプローチと調和します。
    • **CSS Modules/Scoped CSS：**スタイルのカプセル化を保証し、漏れや競合を防ぎます。
    • **Styled Components/Emotion (React) / CSS-in-JS (Vue)：**コンポーネントとスタイルを共配置でき、保守性が向上します。
    • **Utility-first CSS (Tailwind CSS)：**アトムと分子で効果的に使用できますが、カスタムコンポーネントは特定のデザインパターンを統合する可能性があります。
  4. **Storybook/Styleguidist統合：**これらのツールは、コンポーネントを個別に開発、文書化、テストする上で非常に役立ちます。各アトミックステージ（アトム、分子、オルガニズム）には、さまざまな状態とバリエーションを示す独自のストーリーが必要です。これは、デザイナーと開発者がシステムを理解するのを大いに助けます。
  5. **再利用性を最優先：**常に再利用性を念頭に置いてコンポーネントを設計します。アトムは分子で使用するために設計され、分子はオルガニズムで使用され、以下同様です。単一のページに特化しすぎているコンポーネントで、汎用化の可能性がある場合は作成を避けてください。
  6. データフロー：
    • **アトムおよび分子：**主に「プレゼンテーション」コンポーネントです。プロップを介してデータを受け取り、ユーザーインタラクションのためにイベントを発行します。内部値自体を管理する入力フィールドのような、絶対に必要な場合を除き、ステートレスに保ちます。
    • **オルガニズムおよびテンプレート：**自己完結型のセクションを表す場合、データ取得またはステート管理のためのより多くのロジックを導入できます。
    • **ページ：**データ取得、API呼び出し、および実際のアプリケーションデータを使用したさまざまなテンプレートとオルガニズムのオーケストレーションの主要な場所です。

カードコンポーネントの実装例

Cardコンポーネントを検討してみましょう。

アトム：

  • Image.vue / Image.jsx
  • Heading.vue / Heading.jsx
  • Paragraph.vue / Paragraph.jsx
  • Button.vue / Button.jsx

分子： CardContent（Heading、Paragraphを組み合わせる）

<!-- molecules/CardContent.vue -->
<template>
  <div class="card-content">
    <Heading level="3">{{ title }}</Heading>
    <Paragraph>{{ description }}</Paragraph>
  </div>
</template>

<script>
import Heading from '../atoms/Heading.vue';
import Paragraph from '../atoms/Paragraph.vue';

export default {
  components: { Heading, Paragraph },
  props: {
    title: String,
    description: String
  }
};
</script>

オルガニズム： Card（Image、CardContent、Buttonを組み合わせる）

<!-- organisms/Card.vue -->
<template>
  <div class="card">
    <Image :src="imageUrl" :alt="title" />
    <CardContent :title="title" :description="description" />
    <div class="card-actions">
      <Button @click="$emit('viewDetails')">View Details</Button>
    </div>
  </div>
</template>

<script>
import Image from '../atoms/Image.vue';
import CardContent from '../molecules/CardContent.vue';
import Button from '../atoms/Button.vue';

export default {
  components: { Image, CardContent, Button },
  props: {
    imageUrl: String,
    title: String,
    description: String
  }
};
</script>

この明確な階層は、Cardのような複雑なコンポーネントが、より単純で再利用可能な部分からどのように構築されるかを示しています。このアプローチは、保守を大幅に簡素化し、アプリケーション全体での視覚的な一貫性を保証します。

アプリケーションシナリオ

アトミックデザインは、理論的な概念だけでなく、さまざまなシナリオで具体的なメリットをもたらします。

  • **デザインシステム開発：**コンポーネントライブラリの明確なアーキテクチャを提供し、堅牢なデザインシステムのバックボーンを形成します。
  • **大規模アプリケーション：**多くの機能とビューを持つアプリケーションの複雑さを管理するために不可欠です。
  • **チームコラボレーション：**デザイナーと開発者のための共通の言語と構造を提供し、より良いコミュニケーションと効率を促進します。
  • **迅速なプロトタイピング：**事前に構築されたアトムと分子を組み立てることにより、チームは新しい機能とページを迅速に開発できます。
  • **保守とリファクタリング：**コンポーネントを分離することで、UIの他の部分に影響を与えることなく、バグの特定、スタイルの更新、または機能のリファクタリングが容易になります。
  • **クロスプラットフォーム開発：**基本的なUIコンポーネント（アトム、分子）は、多くの場合、さまざまなフロントエンドプラットフォーム（Web、モバイル、デスクトップアプリ）間で共有または簡単に適応できます。

結論：フロントエンドの卓越性のための構造的ブループリント

アトミックデザインは、ReactおよびVueプロジェクトでスケーラブルで保守可能なユーザーインターフェイスを構築するための強力で体系的なアプローチを提供します。インターフェイスを基本的なアトム、分子、オルガニズム、テンプレート、そしてページに分解することにより、開発者とデザイナーは共通の言語と明確なアーキテクチャの階層を得ることができます。この方法論は、コンポーネントの再利用性と一貫性を強化するだけでなく、開発ワークフローを合理化し、プロジェクトの長期的な保守性を大幅に向上させます。アトミックデザインを採用することは、フロントエンド開発の将来の品質と俊敏性への戦略的投資です。

Share this article

HackerNews

More Posts from Leapcell

cover

フロントエンド開発における複雑なフォームのナビゲーション

cover

Viteのコアマジック esbuildとネイティブESMによるフロントエンド開発の再発明

Popular Posts