Webコンポーネント設計

モダンフレームワークを使用して、クリーンな合成パターンとスタイリング手法により、再利用可能で保守しやすいUIコンポーネントを構築します。

このスキルを使用する場合

• 再利用可能なコンポーネントライブラリまたはデザインシステムを設計する
• 複雑なコンポーネント合成パターンを実装する
• CSS-in-Jソリューションを選択して適用する
• アクセシブルでレスポンシブなUIコンポーネントを構築する
• コードベース全体で一貫したコンポーネントAPIを作成する
• レガシーコンポーネントをモダンパターンにリファクタリングする
• 複合コンポーネントまたはレンダープロップを実装する

コアコンセプト

1. コンポーネント合成パターン

複合コンポーネント: 連携して動作する関連コンポーネント

// 使用例
<Select value={value} onChange={setValue}>
  <Select.Trigger>Choose option</Select.Trigger>
  <Select.Options>
    <Select.Option value="a">Option A</Select.Option>
    <Select.Option value="b">Option B</Select.Option>
  </Select.Options>
</Select>

レンダープロップ: 親にレンダリングを委譲する

<DataFetcher url="/api/users">
  {({ data, loading, error }) =>
    loading ? <Spinner /> : <UserList users={data} />
  }
</DataFetcher>

スロット (Vue/Svelte): 名前付きコンテンツ挿入ポイント

<template>
  <Card>
    <template #header>Title</template>
    <template #content>Body text</template>
    <template #footer><Button>Action</Button></template>
  </Card>
</template>

2. CSS-in-Jのアプローチ

ソリューション	アプローチ	最適な用途
Tailwind CSS	ユーティリティクラス	迅速なプロトタイピング、デザインシステム
CSS Modules	スコープ付きCSSファイル	既存CSS、段階的な導入
styled-components	テンプレートリテラル	React、動的スタイリング
Emotion	オブジェクト/テンプレートスタイル	フレキシブル、SSR対応
Vanilla Extract	ゼロランタイム	パフォーマンス重視のアプリケーション

3. コンポーネントAPI設計

interface ButtonProps {
  variant?: "primary" | "secondary" | "ghost";
  size?: "sm" | "md" | "lg";
  isLoading?: boolean;
  isDisabled?: boolean;
  leftIcon?: React.ReactNode;
  rightIcon?: React.ReactNode;
  children: React.ReactNode;
  onClick?: () => void;
}

原則:

• セマンティックなプロップ名を使用する (loading ではなく isLoading)
• 適切なデフォルト値を提供する
• children 経由の合成をサポートする
• className または style でスタイルオーバーライドを許可する

クイックスタート: Tailwind付きReactコンポーネント

import { forwardRef, type ComponentPropsWithoutRef } from "react";
import { cva, type VariantProps } from "class-variance-authority";
import { cn } from "@/lib/utils";

const buttonVariants = cva(
  "inline-flex items-center justify-center rounded-md font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 disabled:pointer-events-none disabled:opacity-50",
  {
    variants: {
      variant: {
        primary: "bg-blue-600 text-white hover:bg-blue-700",
        secondary: "bg-gray-100 text-gray-900 hover:bg-gray-200",
        ghost: "hover:bg-gray-100 hover:text-gray-900",
      },
      size: {
        sm: "h-8 px-3 text-sm",
        md: "h-10 px-4 text-sm",
        lg: "h-12 px-6 text-base",
      },
    },
    defaultVariants: {
      variant: "primary",
      size: "md",
    },
  },
);

interface ButtonProps
  extends
    ComponentPropsWithoutRef<"button">,
    VariantProps<typeof buttonVariants> {
  isLoading?: boolean;
}

export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
  ({ className, variant, size, isLoading, children, ...props }, ref) => (
    <button
      ref={ref}
      className={cn(buttonVariants({ variant, size }), className)}
      disabled={isLoading || props.disabled}
      {...props}
    >
      {isLoading && <Spinner className="mr-2 h-4 w-4" />}
      {children}
    </button>
  ),
);
Button.displayName = "Button";

フレームワークパターン

React: 複合コンポーネント

import { createContext, useContext, useState, type ReactNode } from "react";

interface AccordionContextValue {
  openItems: Set<string>;
  toggle: (id: string) => void;
}

const AccordionContext = createContext<AccordionContextValue | null>(null);

function useAccordion() {
  const context = useContext(AccordionContext);
  if (!context) throw new Error("Must be used within Accordion");
  return context;
}

export function Accordion({ children }: { children: ReactNode }) {
  const [openItems, setOpenItems] = useState<Set<string>>(new Set());

  const toggle = (id: string) => {
    setOpenItems((prev) => {
      const next = new Set(prev);
      next.has(id) ? next.delete(id) : next.add(id);
      return next;
    });
  };

  return (
    <AccordionContext.Provider value={{ openItems, toggle }}>
      <div className="divide-y">{children}</div>
    </AccordionContext.Provider>
  );
}

Accordion.Item = function AccordionItem({
  id,
  title,
  children,
}: {
  id: string;
  title: string;
  children: ReactNode;
}) {
  const { openItems, toggle } = useAccordion();
  const isOpen = openItems.has(id);

  return (
    <div>
      <button onClick={() => toggle(id)} className="w-full text-left py-3">
        {title}
      </button>
      {isOpen && <div className="pb-3">{children}</div>}
    </div>
  );
};

Vue 3: Composables

<script setup lang="ts">
import { ref, computed, provide, inject, type InjectionKey } from "vue";

interface TabsContext {
  activeTab: Ref<string>;
  setActive: (id: string) => void;
}

const TabsKey: InjectionKey<TabsContext> = Symbol("tabs");

// 親コンポーネント
const activeTab = ref("tab-1");
provide(TabsKey, {
  activeTab,
  setActive: (id: string) => {
    activeTab.value = id;
  },
});

// 子コンポーネントの使用
const tabs = inject(TabsKey);
const isActive = computed(() => tabs?.activeTab.value === props.id);
</script>

Svelte 5: Runes

<script lang="ts">
  interface Props {
    variant?: 'primary' | 'secondary';
    size?: 'sm' | 'md' | 'lg';
    onclick?: () => void;
    children: import('svelte').Snippet;
  }

  let { variant = 'primary', size = 'md', onclick, children }: Props = $props();

  const classes = $derived(
    `btn btn-${variant} btn-${size}`
  );
</script>

<button class={classes} {onclick}>
  {@render children()}
</button>

ベストプラクティス

1. 単一責任: 各コンポーネントは1つのことを適切に実行する
2. プロップドリリング防止: 深くネストされたデータにはContextを使用する
3. デフォルトでアクセシブル: ARIA属性とキーボードサポートを含める
4. 制御型と非制御型: 適切な場合は両方のパターンをサポートする
5. Forward Refs: 親がDOMノードにアクセスできるようにする
6. メモ化: 高コストなレンダリングに React.memo と useMemo を使用する
7. エラーバウンダリー: 失敗する可能性があるコンポーネントをラップする

よくある問題

• プロップの増加: プロップが多すぎる場合は合成を検討する
• スタイルの競合: スコープ付きスタイルまたはCSS Modulesを使用する
• 再レンダーの連鎖: React DevToolsでプロファイルして、適切にメモ化する
• アクセシビリティのギャップ: スクリーンリーダーとキーボードナビゲーションでテストする
• バンドルサイズ: 未使用のコンポーネントバリアントをツリーシェイクする