Jetpack Compose カスタムModifier入門:Modifier.then・composed・Nodeの使い分け
Jetpack ComposeのModifierは、見た目の装飾だけでなく、コンポーネントの振る舞いを独立させて再利用するための設計パターンです。本記事では、カスタムModifierを作る3つの主要API——Modifier.then()、Modifier.composed()、Modifier.Node——を比較し、状態を持つModifierを再コンポジションの負荷なく実装する手順を整理します。
Modifier.then():最もシンプルな連結
Modifier.then() は、複数のModifierをチェーンして1つのModifierにまとめる最も基本的な方法です。@Composable 関数の中で LocalContentColor などのCompositionLocalを読み取り、その結果をチェーンに足す用途に向いています。
まずは最小構成の例です。@Composable 関数内で色を読み取り、then で背景Modifierを連結します。
[保護モジュール code0001:composableModifier の最小例]
チェーンの順序は描画結果に影響します。padding → background → clickable の順に並べた例を見てください。
[保護モジュール code0002:padding/background/clickable のチェーン例]
重要なのは、then() がフラットなリストを作るのではなく、CombinedModifier という2要素の再帰構造を組み立てる点です。チェーンは左結合で、((padding then background) then clickable) のような入れ子になります。この双方向走査可能なリンクドリスト構造が、UIパイプラインの各フェーズでModifierを処理する仕組みを支えています。
then の実装と CombinedModifier の走査メソッドは次のとおりです。
[保護モジュール code0003:then と CombinedModifier の実装]
CombinedModifier はコレクションではなく、outer と inner の2要素だけを持つコンテナです。
[保護モジュール code0004:CombinedModifier のクラス宣言]
outer はチェーン内で先に追加されたModifier、inner は新たに追加されたModifierを保持します。この2要素構造が、UIパイプラインの異なるフェーズに対応するための双方向走査を可能にしています。
ただし、@Composable 関数内でしか呼べないModifierは、呼び出し位置より上位へ抽出できません。状態を持たない単純な連結には十分ですが、状態を伴う再利用には次項以降のAPIを検討します。
Modifier.composed():便利だが現在は非推奨
Modifier.composed() は、ラムダ内で remember などの @Composable 関数を呼べるカスタムModifierを作るAPIです。インスタンス専用の状態を保持できるため、同じModifierオブジェクトを複数箇所で安全に再利用できる利点がありました。
状態を持つModifierの例です。
[保護モジュール code0005:myStatefulModifier の例]
内部では ComposedModifier を生成し、then で既存チェーンに連結しています。
[保護モジュール code0006:composed の実装]
では、なぜ現在は推奨されないのでしょうか。理由は2つに分けて考えると整理しやすくなります。
第一に、composed はModifierインスタンスごとにサブコンポジションを必要とします。リストのように同じModifierが多数の要素に適用される場面では、このコストが積み上がります。
第二に、ラムダ内で @Composable 関数を一度も呼ばずに composed を適用するケースです。この使い方では、ComposeはそのModifierを再コンポジション時に読み飛ばせる対象として扱えなくなります。その結果、画面が再描画されるたびにModifierチェーンを最初から評価し直し、状態をそろえ直す処理が走ります。状態を持たないのに composed を選ぶと、得られる利点がないまま再コンポジションのコストだけを負担することになります。
判断の目安:状態を持たないなら then()、状態を持つなら composed ではなく Node を選ぶ、というのが現在の基本方針です。
Modifier.Node:状態とロジックの中核
Modifier.Node は Compose UI 1.3.0 で導入された低レベルAPIで、サブコンポジションのオーバーヘッドなしに状態を持つModifierを実装できます。現在は Modifier.composed に代わる推奨手段です。実装は3つの部品に分かれます。1. Node:状態(例:color)とロジック(例:drawCircle)を持つ可変クラス。DrawModifierNode などを実装します。再コンポジションをまたいでインスタンスが保持され、設定が変わらなければ再利用されます。2. Element:create() でNodeを生成し、update(node) で既存Nodeの状態を更新します。Elementが変更されたかは equals で判定されるため、equals と hashCode の正しい実装が必須です。最も簡単な方法は data class の使用です。3. Factory:開発者が呼ぶ公開API関数。then 演算子で新しい Element を既存チェーンに連結します。Nodeの例です。状態 color を保持し、描画ロジックを実装します。[保護モジュール code0007:CircleNode の例] Factoryは then で Element を連結するだけの薄い公開APIです。[保護モジュール code0008:circle ファクトリの例] ステートレスな Element とステートフルな Node を分離することで、オブジェクト生成を最小化し、再利用性を最大化できます。自社SDKでこのパターンを採用する場合は、まず既存の composed ベースのModifierを洗い出し、状態をNodeへ、生成と更新をElementへ、公開APIをFactoryへと段階的に切り分けると移行しやすくなります。移行後は、リスト表示などで再コンポジション回数とアロケーションの変化を計測し、効果を確認するのがおすすめです。
実装前チェックリスト
- 状態を持つか? 持たないなら then() で十分。持つなら Node を選ぶ。
- composed を使っていないか? 使っているなら Node への移行を検討する。
- Element は data class か、equals/hashCode を正しく実装しているか? 未実装だと update が不要に呼ばれ、性能上の利点が失われる。
- Node のインスタンスが再コンポジションをまたいで保持される前提でロジックを書いているか?
- Factory は then で Element を連結するだけの薄い公開APIになっているか?
まとめ
3方式にはそれぞれトレードオフがあります。then() はシンプルで軽量、composed() は誤用すると性能低下を招き、Node はモダンで効率的な方法を提供します。パターンを理解して意図的に使い分けることで、再利用性・表現力・性能を兼ね備えたCompose UIを構築できます。
Frequently asked questions
Modifier.composed() はなぜ非推奨なのですか?
各Modifierインスタンスごとにサブコンポジションを生成するコストがあり、@Composable 関数を実際に呼ばない場合でもModifierがスキップ可能と見なされず、再コンポジション時にチェーン全体を再実行する必要が生じるためです。現在は Modifier.Node が推奨されています。
ModifierNodeElement で equals/hashCode を実装しないとどうなりますか?
Elementの変更判定が正しく行われず、update が不要に呼ばれてNode再利用の性能上の利点が失われます。data class を使うのが最も簡単な正しい実装方法です。
Modifier.Node はどのバージョンから使えますか?
Compose UI 1.3.0 から導入されています。