---
title: "Reactのコンポジションとは？boolean propsを減らす設計と「Composition Is All You Need」解説【React 19.3】"
url: "https://www.issoh.co.jp/tech/details/10199/"
published: 2025-12-09
updated: 2026-11-10
categories: ["React"]
publisher: "株式会社一創"
---

# Reactのコンポジションとは？boolean propsを減らす設計と「Composition Is All You Need」解説【React 19.3】

Reactのコンポジション（composition）は、小さな部品をchildrenやその他のpropsを通じて組み合わせ、UIを作る考え方です。VercelのFernando Rojo氏がReact Universe Conf 2025で行った講演「Composition Is All You Need」は、これをSlackのメッセージ入力欄（コンポーザー）に当てはめ、`isThread` や `isEditing` のようなboolean propsが増え続ける部品を、Compound Componentsと状態の持ち上げで組み直しました。

この記事ではReact 19.3.1で動かしたTypeScriptのコードで組み直しを再現し、再レンダリング回数、React Compiler 1.0で対象外になる書き方、Next.jsのServer Componentsで落ちる書き方を実測で示します。

## まとめ：講演の要点と採用の判断

- 問題は「親から渡すbooleanで描画する部品の木を切り替える」設計です。
- 解決策は、部品を `Composer.Frame`・`Composer.Input` のような小さな部品に割り、用途ごとに別のコンポーネントとしてJSXで組み直すことです。
- 状態は `state`・`actions`・`meta` を持つContextで受け渡します。講演者が「1つだけ持ち帰るなら」（17:34）と挙げたのは状態の持ち上げで、Providerを外へ出せば入力欄の枠の外にあるボタンからも送信できます。
- 初回描画と入力10回の描画回数は、boolean部品の99回に対してCompound Componentsが69回でした。ただしboolean部品にReact Compilerを入れるだけでも69回まで減るため、移行の理由は描画回数ではなく分岐の整理に置きます。
- 部品をオブジェクトにまとめて書き出すと、Next.jsのServer Componentから `Composer.Input` と辿った時点でビルドが失敗します。名前付きexportと `import * as` で避けられます。
- 用途が2つ程度で増えない部品や、`disabled` のようにHTMLの属性そのものを表すbooleanには適用しません。

## Reactのコンポジションとは：childrenとpropsで部品を組む基本

コンポジションの出発点は、JSXタグの内側に書いた内容が `children` propとして部品に渡る仕組みです。旧公式ドキュメントの[Composition vs Inheritance](https://legacy.reactjs.org/docs/composition-vs-inheritance.html)は、中身を知らない箱型の部品（Containment）と、汎用部品の特殊形（Specialization）の2つに分けて説明し、「we haven’t found any use cases where we would recommend creating component inheritance hierarchies」と継承の階層を勧めていません。

現行の公式ドキュメントも、[Contextを使う前に](https://react.dev/learn/passing-data-deeply-with-context)propsの受け渡しか「JSXをchildrenとして渡す」構成を試すよう書いています。講演が新しかったのは、この基本を知っている開発者でも実務では「既存の部品にフラグを1つ足す」方向へ流れやすいことを、具体的な画面で順に見せた点です。`children` とpropsの使い分けは[Reactのchildrenの解説](/tech/details/4116/)、オブジェクト指向側の議論は[継承と委譲の使い分け](/tech/details/2724/)で扱っています。

## 「Composition Is All You Need」の講演情報と動画の公開先

React Universe Conf 2025はポーランドのヴロツワフで2025年9月2日から4日に開かれ、動画は主催のCallstackが2025年9月8日に[YouTube](https://www.youtube.com/watch?v=4KvbVq3Eg5w)へ公開しました。長さは22分17秒です。締めは「15個のbooleanに埋もれたら、composition is all you needを思い出して」という一言です。

## boolean propsが増える経緯：Slackのコンポーザーの例

Slackのコンポーザー（動画の1:58〜）は、見た目は1つでも用途ごとに少しずつ違います。

| 用途         | 他と違う点          | 状態の持ち方   |
| ---------- | -------------- | -------- |
| チャンネル      | 基準形（添付・絵文字・送信） | 端末間で同期   |
| チャンネルのスレッド | 「チャンネルにも送信」欄   | 端末間で同期   |
| DMのスレッド    | 「DMとしても送信」欄    | 端末間で同期   |
| メッセージ編集    | 添付なし・キャンセルと保存  | 端末間で同期   |
| メッセージ転送    | 送信ボタンが入力欄の外    | ダイアログ内だけ |

素直に作ると、部品の中は次のような三項演算子の連なりになります。

```
function Composer({ onSubmit, isThread, channelId, isDMThread, dmId, isEditing, isForwarding }) {
  return (
    <form>
      <Header />
      <Input />
      {isDMThread ? <AlsoSendToDMField id={dmId} /> : isThread ? <AlsoSendToChannelField id={channelId} /> : null}
      {isEditing ? <EditActions /> : isForwarding ? <ForwardActions /> : <DefaultActions />}
      <Footer onSubmit={onSubmit} hideAttachments={isEditing} />
    </form>
  );
}
```

編集では添付の「+」ボタンが無いので、ドラッグ＆ドロップの受け口も止めなければなりません。Rojo氏は「親から渡すbooleanで描画する部品の木を決めているなら、肩越しに首を振っている私を想像してほしい」（8:16）と述べています。Vercelのスキルのルール文も「Each boolean doubles possible states」と書いており、上のbooleanが4つあると、入力としては16通りの組み合わせを指定でき、意図しない組み合わせも渡せます。

## Compound Componentsでの組み直し：用途別の部品構成

講演は「Radixのコンポーネントのように機能を作ったらどうか」（10:04）と問いかけ、1つの大きな部品を `Composer.Provider`・`Composer.Frame`・`Composer.Input` などに割ります。部品同士はContextで状態を共有し、使う側は必要な部品だけをJSXで並べます。[Radix UIのPrimitives](/tech/details/7856/)や[Base UI](/tech/details/10350/)も同じ構造で、独自の要素と組み合わせる窓口はRadixが[asChild](https://www.radix-ui.com/primitives/docs/guides/composition)、Base UIが[render prop](https://base-ui.com/react/handbook/composition)です。

### 部品の定義：Contextを読む小さな部品の集まり

次のコードは react 19.3.1 と TypeScript 7.0.2（strict）で動作と型を確認したものです。`useComposer` はProviderの外で呼ばれたら例外を投げ、使い方の誤りを早く見つけられるようにしています。

```
import { createContext, use, useState, useRef } from 'react';
import type { ReactNode, RefObject } from 'react';

type ComposerState = { input: string };
type ComposerActions = {
  update: (updater: (s: ComposerState) => ComposerState) => void;
  submit: () => void;
};
type ComposerMeta = { inputRef: RefObject<HTMLTextAreaElement | null> };
type ComposerContextValue = { state: ComposerState; actions: ComposerActions; meta: ComposerMeta };

const ComposerContext = createContext<ComposerContextValue | null>(null);

export function useComposer(): ComposerContextValue {
  const ctx = use(ComposerContext);
  if (ctx === null) throw new Error('Composer.* は Provider の内側で使う');
  return ctx;
}

function ComposerProvider({ state, actions, meta, children }: ComposerContextValue & { children: ReactNode }) {
  return <ComposerContext value={{ state, actions, meta }}>{children}</ComposerContext>;
}

function ComposerFrame({ children }: { children: ReactNode }) {
  return <form onSubmit={(e) => e.preventDefault()}>{children}</form>;
}

function ComposerInput({ placeholder }: { placeholder?: string }) {
  const { state, actions, meta: { inputRef } } = useComposer();
  return (
    <textarea
      ref={inputRef}
      aria-label="メッセージ"
      placeholder={placeholder}
      value={state.input}
      onChange={(e) => actions.update((s) => ({ ...s, input: e.target.value }))}
    />
  );
}

function ComposerSubmit() {
  const { actions } = useComposer();
  return <button type="button" onClick={actions.submit}>送信</button>;
}

export const Composer = {
  Provider: ComposerProvider,
  Frame: ComposerFrame,
  Input: ComposerInput,
  Submit: ComposerSubmit,
};
```

### 用途ごとのコンポーザー：booleanの代わりに別コンポーネント

スレッド用は、チャンネル用に「チャンネルにも送信」欄を1つ足した別コンポーネントです。編集用は添付とドロップ領域を最初から置きません。講演の言葉では「booleanで決めるのではなく、描画しないだけ」です。次は構成を示す抜粋で、Header・Footerや各Providerの実装は省いています。

```
function ThreadComposer({ channelId }: { channelId: string }) {
  return (
    <ChannelProvider channelId={channelId}>
      <Composer.Frame>
        <Composer.Header />
        <Composer.Input />
        <AlsoSendToChannelField channelId={channelId} />
        <Composer.Footer>
          <Composer.CommonActions />
          <Composer.Submit />
        </Composer.Footer>
      </Composer.Frame>
    </ChannelProvider>
  );
}

function EditMessageComposer({ messageId, onCancel }: { messageId: string; onCancel: () => void }) {
  return (
    <EditMessageProvider messageId={messageId}>
      <Composer.Frame>
        <Composer.Input />
        <Composer.Footer>
          <Composer.Formatting />
          <Composer.Emojis />
          <CancelButton onClick={onCancel} />
          <SaveButton />
        </Composer.Footer>
      </Composer.Frame>
    </EditMessageProvider>
  );
}
```

左下のボタン群は `CommonActions` に束ねますが、この部品は `isEditingMessage` のようなpropsを受け取りません。形が違う用途は `CommonActions` を使わず、個別の部品を並べ直します。共通化はしてよいが、共通化した部品に分岐を戻さない、という線引きです。

### TypeScriptの型検査：用途別propsの必須項目と誤指定の検出

boolean部品のpropsをすべて省略可能で型付けすると、`<BooleanComposer isThread isEditing isForwarding />` のように矛盾した指定も、`channelId` の渡し忘れも通ります。用途別に分けた `<ThreadComposer />` はTypeScript 7.0.2でTS2741（`channelId` が無い）になり、実装していない `Composer.Header` を使うとTS2339で止まります。実行時の条件分岐で守っていたものが、型の検査へ移ります。

## 状態の持ち上げ：state・actions・metaのインターフェース

チャンネルやスレッドの下書きは入力中に端末間で同期されますが、転送ダイアログの下書きは閉じたら破棄されます。講演はContextが「インターフェース（`state`・`actions`・`meta`）」だけを決め、実装はProviderを描画する側が持つ形を示しました。

### Providerが実装を隠す：useStateと同期フックの差し替え

転送用のProviderは `useState` で持ちます。チャンネル用なら、講演中の架空のフック `useGlobalChannel` が返す値を同じ形に当てはめるだけで、`Composer.Input` はどちらの下でも同じコードで動きます。`meta` には入力欄のrefのように「状態ではないが部品間で共有したいもの」を入れます。

```
export function ForwardMessageProvider({ onForward, children }: { onForward: (text: string) => void; children: ReactNode }) {
  const [state, setState] = useState<ComposerState>({ input: '' });
  const inputRef = useRef<HTMLTextAreaElement | null>(null);
  const submit = () => onForward(state.input);
  return (
    <Composer.Provider state={state} actions={{ update: setState, submit }} meta={{ inputRef }}>
      {children}
    </Composer.Provider>
  );
}
```

### Frameの外にあるボタン：Provider内での状態と操作の共有

Slackの転送ダイアログでは「転送」ボタンが入力欄の枠の外にあります。`isForwardingMessage` を足して入力値を `useEffect` で親へ返す必要はありません。公式ドキュメントも、2つのstateを同期させようとしているなら[共通の親へ持ち上げる](https://react.dev/learn/you-might-not-need-an-effect#notifying-parent-components-about-state-changes)よう書いています。

```
function ForwardButton() {
  const { state, actions } = useComposer();
  return <button type="button" onClick={actions.submit}>転送（{state.input.length}字）</button>;
}

export function ForwardMessageDialog({ onForward }: { onForward: (text: string) => void }) {
  return (
    <ForwardMessageProvider onForward={onForward}>
      <Composer.Frame>
        <Composer.Input placeholder="メッセージを追加（任意）" />
      </Composer.Frame>
      {/* Frame の外だが Provider の内側にある */}
      <ForwardButton />
    </ForwardMessageProvider>
  );
}
```

react-dom 19.3.1とjsdomで描画し、入力欄に「お疲れさまです」と入れて転送ボタンを押すと、表示は「転送（7字）」になり、`onForward` に同じ文字列が渡りました。ボタンの祖先に `form` 要素はありません。

## 再レンダリング回数の実測：boolean部品・Compound Components・React Compiler

「Contextは再レンダリングが増える」とよく言われるので、入力更新だけを比較するために簡略化した画面（計数対象9個）を3つの構成で作り、StrictModeを使わず、それぞれReact Compilerの有無で各部品の関数呼び出し回数を数えました。初回描画1回と文字入力10回の合計です。環境はreact 19.3.1、jsdom 31.0.0、babel-plugin-react-compiler 1.0.0で、回数は実行時間ではありません。入力欄・送信ボタン・状態を持つ部品は全構成で11回なので表から省いています。

| 構成                  | 合計 | Frame | Header | CommonActions | Emojis |
| ------------------- | -- | ----- | ------ | ------------- | ------ |
| boolean部品           | 99 | 11    | 11     | 11            | 11     |
| boolean部品＋Compiler  | 69 | 11    | 1      | 11            | 1      |
| Compound Components | 69 | 1     | 1      | 11            | 11     |
| Compound＋Compiler   | 49 | 1     | 1      | 11            | 1      |
| Contextを2つに分割       | 39 | 1     | 1      | 1             | 1      |
| 分割＋Compiler         | 39 | 1     | 1      | 1             | 1      |

Compound Componentsで `Frame` と `Header` が1回で済むのは、Providerの再描画で `children` の要素が作り直されないためです。

boolean部品にCompilerを入れただけの69回は、Compiler無しのCompound Componentsと同じ回数です。コンポジションへ移す理由は、条件分岐の重複を消せるかどうかで判断します。

Compilerを入れても、Contextを読む `CommonActions` の関数は11回呼ばれました。[memoの公式説明](https://react.dev/reference/react/memo#updating-a-memoized-component-using-a-context)どおり、メモ化してもContextが変われば再レンダーされます。配下の `Emojis` の出力だけがメモ化で1回に収まります。Contextの読み手を減らすなら、`state` と `actions` を別のContextに分け、`actions` の参照を固定します。

```
const latest = useRef(state);
useEffect(() => { latest.current = state; });
const actions = useMemo(
  () => ({ update: setState, submit: () => onForward(latest.current.input) }),
  [onForward],
);
return <ActionsContext value={actions}><StateContext value={state}>{children}</StateContext></ActionsContext>;
```

この測定では `submit` が入力値を閉じ込めているため、分割しない構成の `actions` は毎回作り直されます。分割はコード量が増えるので、計測で `CommonActions` のような部品が重いと分かってから入れます。

## React 19.3とReact Compiler 1.0で変わる書き方

講演のコードはReact 19の書き方を前提にしています。npmの `react` は19.3.1、`babel-plugin-react-compiler` は1.0.0が最新です（2026年11月10日時点）。版ごとの変更点は[Reactの最新バージョンの解説](/tech/details/4509/)にまとめています。

| 書き方          | React 18まで           | React 19以降     |
| ------------ | -------------------- | -------------- |
| Providerの指定  | <Ctx.Provider value> | <Ctx value>    |
| Contextの読み取り | useContext(Ctx)      | use(Ctx) も可    |
| refの受け取り     | forwardRef で包む       | ref をpropsで受ける |

[React 19の公式ブログ](https://react.dev/blog/2024/12/05/react-19)は、`forwardRef` を将来の版で非推奨化して削除すると書いています（移行は[forwardRefの解説](/tech/details/4382/)）。`use` は条件分岐の中でも呼べますが、[公式リファレンス](https://react.dev/reference/react/use)は「Contextを `use` で読むのはServer Componentsでは非対応」としています。`useContext` 自体は非推奨ではなく、Vercelのスキルが「`useContext` の代わりに `use`」と書くのは同社の方針です。詳しくは[React useの使い方](/tech/details/2989/)と[React Contextの使い方](/tech/details/2681/)で扱っています。

### Compilerが黙って対象外にする2つの書き方

Compilerは対象にできない書き方を見つけると、エラーにせずその関数を素のまま出力します。babel-plugin-react-compiler 1.0.0で次の2点を確認しました。

- `ref={meta.inputRef}` のようにオブジェクトのプロパティを直接 `ref` に渡すと、@babel/core 7.29.13でも8.1.0でも「Cannot access refs during render」となり、その部品はメモ化されません。`const { meta: { inputRef } } = useComposer()` と分割代入すれば成功します。Vercelのスキルは2通りの書き方が混在しているので、写すときは分割代入に揃えます。
- @babel/core 8.1.0では、`{ placeholder = '...' }` のようにpropsの既定値を分割代入で書いた部品が「BuildHIR::lowerAssignment」で対象外になりました。7.29.13では成功します。npmの `@babel/core` のlatestは8系に移っているので、指定なしで入れるとこの組み合わせになります。

どちらもビルドは通ります。`logger` オプションの `logEvent` で `CompileError` を出力すると、外れた部品を確認できます。仕組みは[React Compilerの解説](/tech/details/9415/)を参照してください。

## Server Componentsから使うときの注意：ドット記法がビルドで落ちる条件

React公式は[Server ComponentsはContextを作れないが、Client ComponentのモジュールからインポートしたProviderは描画できる](https://react.dev/reference/rsc/server-components#rendering-a-context-provider-in-a-server-component)としています。では `'use client'` を付けたファイルの `Composer.Input` をサーバー側のページから直接書けるか。Next.js 16.4.5で `next build` した結果です。

| ページ（Server Component）の書き方         | 結果        |
| --------------------------------- | --------- |
| import { Composer } でオブジェクトを読む    | プリレンダーで失敗 |
| 名前付きexportを import \* as Composer | 成功        |
| ‘use client’ の部品で包んで読む            | 成功        |

1行目の失敗は「Element type is invalid … but got: undefined」というメッセージで、原因が書かれていません。Client Componentのモジュールをサーバーから読むと、オブジェクトの中身までは辿れないためです。ライブラリとして配るなら各部品を名前付きで書き出しておくと、サーバー側からもドット記法で使えます。

```
// composer.tsx（先頭に 'use client'）
export function Provider({ children }: { children: ReactNode }) { /* 略 */ }
export function Frame({ children }: { children: ReactNode }) { /* 略 */ }
export function Input() { /* 略 */ }

// app/page.tsx（Server Component）
import * as Composer from './composer';

export default function Page() {
  return (
    <Composer.Provider>
      <Composer.Frame><Composer.Input /></Composer.Frame>
    </Composer.Provider>
  );
}
```

サーバーとクライアントの境界は[React Server Componentsの解説](/tech/details/4003/)で扱っています。

## 既存のboolean部品をコンポジションへ移す5つの手順

一度に書き換えると差分が読めなくなります。呼び出し元を動かしたまま進める順序は次のとおりです。

1. 同じbooleanが何か所の分岐に現れるかを検索し、用途を列挙する。
2. 部品の中の状態を `state`・`actions`・`meta` の形に整え、Providerへ移す。
3. 内部の部品を切り出し、既存のboolean部品はそれらを並べるだけの薄いラッパーにする（呼び出し元はまだ変えない）。
4. 用途ごとに別コンポーネントを作り、呼び出し元を1か所ずつ置き換える。
5. booleanをpropsの型から消し、`tsc` のエラーで残りの呼び出し元を洗い出して、ラッパーを削除する。

手順3までは画面が変わりません。ここで止めても、分岐は1か所に集まった状態で残ります。カスタムフックへの切り出しは[Reactカスタムフックのベストプラクティス](/tech/details/4147/)で扱っています。

## Vercelのcomposition-patternsスキル：AIエージェント向けの8ルール

Rojo氏は講演で、コンポジションで書かれたコードは「AIがハルシネーションを起こしにくい」と述べました。その内容は2026年1月26日にRojo氏のコミットで [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) の `skills/composition-patterns` として公開され、最終更新は同年1月28日です（版は1.0.0）。`npx skills add vercel-labs/agent-skills` で導入できます。

| 分類           | ルール名                       | 内容                            |
| ------------ | -------------------------- | ----------------------------- |
| Architecture | avoid-boolean-props        | 挙動の切り替えにbooleanを足さない          |
| Architecture | compound-components        | 共有Contextを持つ部品群に割る            |
| State        | decouple-implementation    | 状態の実装はProviderだけが知る           |
| State        | context-interface          | state・actions・metaの汎用型        |
| State        | lift-state                 | 兄弟から読む状態はProviderへ            |
| Patterns     | explicit-variants          | モードではなく別コンポーネント               |
| Patterns     | children-over-render-props | renderXより children            |
| React 19     | no-forwardref              | refはpropsで受け、Contextはuse()で読む |

スキルのコード例はReact Nativeの `TextInput` と `onPress` で書かれているので、Webでは `textarea` と `onClick` への読み替えが要ります。React 19のルールは「Skip this if you’re on React 18 or earlier」と明記されています。モバイルも含めた部品設計は[Flutter / React Native開発](/service/apps/cross%5Fplatform/)でも支援しています。

## コンポジションを採用しない方がよい場面

講演の処方は「同じ条件分岐が部品のあちこちに出てくる」状態に向けたものです。次の場合はbooleanを1つ足す方が読みやすく、部品を割るコストだけが残ります。

- **用途が2つで、3つ目の予定が無い部品**：分岐が1か所に収まるなら、部品群とProviderを作る方がコード量は増えます。
- **HTMLの属性そのものを表すboolean**：`disabled`・`required`・`checked` は描画する部品の木を切り替えないため、講演の批判の対象外です。
- **見た目だけの差**：色やサイズの違いは `variant="primary"` のような文字列propsで足ります。
- **状態共有が不要な静的画面へのContext導入**：childrenでJSXを組むコンポジションはServer Componentsでも使えます。ただし、Contextを読む部品はすべてClient Componentになるので、部品を割る利点が小さくなります。

判断の目安は、booleanが「部品の中の何を描画するか」を決めているかどうかです。

## よくある質問

### 「Composition Is All You Need」の動画はどこで見られますか？

React Universe Conf 2025を主催したCallstackのYouTubeチャンネルで[公式動画](https://www.youtube.com/watch?v=4KvbVq3Eg5w)が公開されています。タイトルは「Composition Is All You Need | Fernando Rojo at React Universe Conf 2025」で、長さは22分17秒です。英語の字幕があります。

### shouldRenderButtonやisEditingは講演に出てくる名前ですか？

講演の英語字幕を全文検索すると、出てくるのは is thread・is DM thread・is editing message・is forwarding message などで、shouldRenderButtonという語はありません。Vercelのスキルのコード例でも、使われているのは `isThread`・`isDMThread`・`isEditing`・`isForwarding` です。検索で見かける要約に別の名前があれば、動画か上記のリポジトリで確かめてください。

### 講演のコードやスライドはGitHubで見られますか？

講演の考え方をコードにしたものは [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) の `skills/composition-patterns/rules` に、ルールごとのMarkdownとして置かれています。例はReact Native向けです。スライド自体の公式な配布先は、この記事の執筆時点では確認できていません。

### React 18でもこのパターンは使えますか？

使えます。Compound Componentsと状態の持ち上げはReact 16.3以降のContext APIで書けます。React 18では `<Ctx.Provider value>` と `useContext`、refを受ける部品は `forwardRef` に書き換えてください。

### render propsとの違いは何ですか？

render propsは `renderFooter` のような関数propsで描画を差し込みます。講演が指摘しているのは、既存コンポーザーの内部で呼ぶrenderFooterだけでは、その外側にある転送ボタンを配置できないという制約です。Vercelのスキルは `renderX` より `children` を使うルールを置いています。

## 関連記事

- [Reactのchildrenとは？propsとの違い・型定義・Children APIの代替【React 19.3対応】](/tech/details/4116/)
- [React Contextの使い方｜createContext・useContext・Providerの実装と再レンダー対策【React 19.3対応】](/tech/details/2681/)
- [React Compilerとは？Vite・Next.js・Expoでの導入とRust版・ESLint・useMemoの扱い【2026年10月】](/tech/details/9415/)
- [Radix UIとは？PrimitivesとThemesの違い・導入手順【radix-ui 1.8対応】](/tech/details/7856/)
- [React Server Components（RSC）とは？サーバーとクライアントの違い・使い分けと確認方法【React 19.3】](/tech/details/4003/)

---

出典: [Reactのコンポジションとは？boolean propsを減らす設計と「Composition Is All You Need」解説【React 19.3】](<https://www.issoh.co.jp/tech/details/10199/>)（株式会社一創）
