React

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

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は、中身を知らない箱型の部品(Containment)と、汎用部品の特殊形(Specialization)の2つに分けて説明し、「we haven’t found any use cases where we would recommend creating component inheritance hierarchies」と継承の階層を勧めていません。

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

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

React Universe Conf 2025はポーランドのヴロツワフで2025年9月2日から4日に開かれ、動画は主催のCallstackが2025年9月8日にYouTubeへ公開しました。長さは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やBase UIも同じ構造で、独自の要素と組み合わせる窓口はRadixがasChild、Base UIがrender propです。

部品の定義: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を同期させようとしているなら共通の親へ持ち上げるよう書いています。

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の公式説明どおり、メモ化しても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の最新バージョンの解説にまとめています。

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

React 19の公式ブログは、forwardRef を将来の版で非推奨化して削除すると書いています(移行はforwardRefの解説)。use は条件分岐の中でも呼べますが、公式リファレンスは「Contextを use で読むのはServer Componentsでは非対応」としています。useContext 自体は非推奨ではなく、Vercelのスキルが「useContext の代わりに use」と書くのは同社の方針です。詳しくはReact useの使い方とReact Contextの使い方で扱っています。

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の解説を参照してください。

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

React公式はServer ComponentsはContextを作れないが、Client ComponentのモジュールからインポートしたProviderは描画できるとしています。では '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の解説で扱っています。

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

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

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

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

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

Rojo氏は講演で、コンポジションで書かれたコードは「AIがハルシネーションを起こしにくい」と述べました。その内容は2026年1月26日にRojo氏のコミットで 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開発でも支援しています。

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

講演の処方は「同じ条件分岐が部品のあちこちに出てくる」状態に向けたものです。次の場合は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チャンネルで公式動画が公開されています。タイトルは「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 の 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 を使うルールを置いています。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.18 テックブログ Java脆弱性CVE-2026-114938(Java4Shell)とは?影響版・修正版と回避フラグの実装手順
  2. 2026.11.11 テックブログ Vite 脆弱性 GHSA-p4f5-76q4-ffq7:開発サーバーRCEの確認と修正版への更新
  3. 2026.11.18 テックブログ 楽天証券の不正アクセス:最大約447万口座の対象確認と、テスト環境に本番データを置かない実装
  4. 2026.11.17 テックブログ チャットプラスの不正アクセス:導入企業がチャット履歴の個人データと報告準備を確かめる手順
  5. 2026.11.19 テックブログ 大崎電気のランサムウェア被害|スマートメーター生産停止の経緯と工場の生産系を守る手順

RELATED POSTS 関連記事

目次