Recomposed
Modifier

Modifierの順序が重要な理由:プロパティバッグではなくラッパーチェーンだから

Oct 4, 2026 · 7 min read

Modifierの順序が重要な理由:プロパティバッグではなくラッパーチェーンだから

直感

Modifier.a().b().c() は、composableに3つの独立したプロパティを設定しているように読めますが、実際にはそうではありません。

  • 各modifierは、チェーン内で自分より後に続くすべてをラップします。
  • 順序が変わると、各modifierが入力として受け取るもの(利用可能なサイズ、コンテンツ、タッチターゲット)が変わります。
  • 同じmodifierの集まりでも順序が違えば、出来上がるピクセルも振る舞いも異なります。

入力はチェーンを下へ流れます。a が b に何を渡すかを決め、b が c に何を渡すかを決め、という具合です。結果はチェーンを上へ戻ります。a 自身のサイズや見た目は、最終的に b、c、そしてコンテンツがどうなるかに依存します。a と b を入れ替えれば、誰が誰のために決定するかが入れ替わります。

典型例:paddingとbackground

// paddingがbackgroundをラップする:利用可能な空間が先に縮小され、
// 残った領域の内側にbackgroundが描画される。paddingの隙間には赤が見えない。
Modifier.padding(16.dp).background(Color.Red)
 
// backgroundがpaddingをラップする:backgroundが先に全体サイズを塗り、
// paddingはコンテンツを内側に押し込むだけ。赤が全領域を満たす。
Modifier.background(Color.Red).padding(16.dp)

同じ形、同じ2つのmodifier、順序が違うだけで結果が異なるのは、プロパティを設定しているのではなく、ラッパーを入れ子にしているからです。

FIG. 01
同じ2つのmodifierで順序を入れ替えた例:paddingの後にbackgroundを置くと隙間が残り(左)、backgroundの後にpaddingを置くとその隙間も赤で満たされる(右)。

同じ理屈、別の組み合わせ

  • clickable().padding() と padding().clickable():リップルとタッチターゲットは、チェーン内で clickable が挿入された時点でのノードのサイズそのものになります。clickable を padding より前に置くと、paddingの領域もクリック可能になります。後に置くとそうはなりません。
  • 描画順も同じ規則に従います。チェーン内のmodifierの順序は描画順でもあるため、.background().padding() と .padding().background() はレイアウトだけでなく描画順でも見た目が異なります。

順序が重要でない場合

この規則は「ラップする順序が振る舞いを変える」であって、「ラップする順序が常に振る舞いを変える」ではありません。実際に交換可能な組み合わせもいくつかあり、どれがそうなのかを知っておくことで、もともと問題でなかった順序について無駄に悩まずに済みます。

clip() + size()。 clip() は何も移動させたりリサイズしたりしません。内側に入れ子になっているものに対する純粋な描画範囲の制限です。size() と組み合わせる場合は順序がほとんど問題にならないケースで、clip() はどちらの順序でも内側に入ってくるサイズをそのまま継承するだけです。

// sizeが外側、clipが内側:sizeは内側に入れ子になったすべて(clipを含む)に
// 100dpを強制するので、clipの範囲も結局100dpになる。
Modifier.size(100.dp).clip(CircleShape)
 
// clipが外側、sizeが内側:clip自体にはサイズがなく、制約をそのまま
// 通過させるだけなので、sizeは変わらず100dpを強制し、
// clipの範囲も変わらず100dpになる。
Modifier.clip(CircleShape).size(100.dp)

どちらも同じ円になります。clip() が順序に敏感になるのは、border() や background() のように自分自身で何かを描画するmodifierと組み合わせたときだけです。

同種のmodifierを重ねる場合。 padding() は制約を一定量だけ縮小し、加算は交換可能なので、padding() を2回重ねても順序に関係なく常に同じ合計の内側マージンになります。

Modifier.padding(start = 8.dp).padding(top = 4.dp)
Modifier.padding(top = 4.dp).padding(start = 8.dp)
// どちらの順序でも結果は同じ:先端から8dp、上端から4dpの内側マージン

alpha() も同じ理屈です。各呼び出しは現在の不透明度に乗算し、乗算も交換可能なので、alpha(0.5f).alpha(0.8f) と alpha(0.8f).alpha(0.5f) はどちらも最終的な不透明度0.4に落ち着きます。

modifierが行う「ラップ」が結合的・交換的な演算(マージンの加算、不透明度の乗算)にすぎない場合、順序は問題にならなくなります。これは下のCalloutにある 2 + 3 == 3 + 2 と同じ理屈です。

サイズ、コンテンツ、描画範囲を消費するmodifier(background、clip、clickable)こそが、順序が決定的な意味を持つものです。

根本原理

これは関数合成です。Modifier.a().b() は a(b(x)) のように振る舞います。関数合成は順序に依存します。f(g(x)) は通常 g(f(x)) とは異なります。2 + 3 と 3 + 2 は同じですが、x / 2 と 2 / x は同じではない、というのと同じことです。

同じことを言い換えれば、これはデコレーターパターンです。各デコレーターは渡されたオブジェクトをラップし、各レイヤーは自分の内側にあるものしか見えず、外側にあるものは見えないため、ラップする順序が振る舞いを変えます。

他の場所でも:根本原理は同じ、フレームワークが違うだけ

  • OkHttpのインターセプター:インターセプターチェーンは登録順に実行され、各インターセプターは次のものをラップします。ロギング用インターセプターをリトライ用インターセプターの前に置くと、最初の試行しか見えません。後に置くと、リトライされたすべての試行が見えます。これも「ラッパーの順序が各レイヤーに何を観測させるかを変える」という同じ仕組みです。
  • CSSのtransform:transform: translate(50px) rotate(45deg) と rotate(45deg) translate(50px) は異なる結果になります。各transform関数は、その前の関数が残した座標空間の中で動作するためです。
  • SwiftUIのview modifier:最も近い類似物です。各modifierは新しいラップされた View 型を返すため、.padding().background() と .background().padding() は全く同じ罠であり、.clipShape() を .background()/.overlay() の前に置くか後に置くかで、同じ角丸のバグが再現されます。
  • Flutterのウィジェット:さらに直接的です。Flutterはチェーン構文を介さずにラッパーツリーをそのまま書き出すためです。ClipRRect(child: Container(color: ...)) と Container(color: ..., child: ClipRRect(...)) は、まさにclip/backgroundの例そのもので、チェーン呼び出しの代わりに入れ子のコンストラクタとして書かれているだけです。
  • WPF/XAML:<Border Padding="16"><Border Background="Red"/></Border> と、入れ子を逆にしたものは同じ振る舞いをします。XAMLの要素は文字どおり入れ子になったオブジェクトであり、CSSと同じ仕組みがマークアップとして書かれているだけです。

実際に人を躓かせる場所

これらは作り話の例ではなく、実際に報告されているバグです。

角丸カードのbackgroundが角で四角く見える

よくある原因は、プレーンな background(color) オーバーロードが単に矩形を塗るだけで、形状について何も知らないことです。丸くなるのは、それが内側で clip() に入れ子になっている場合だけです。

// clipが外側、backgroundが内側:矩形の塗りがclipの内側に入れ子になっているため、
// 丸い形状に切り取られる。角が一致する。
Modifier.clip(RoundedCornerShape(12.dp))
    .background(Color.Gray)
 
// backgroundが外側、clipが内側:backgroundは、内側に入れ子になったclipが
// 実行される前に矩形全体を塗ってしまうため、chainにclipがあるにもかかわらず
// 角は一度も切り取られない。
Modifier.background(Color.Gray)
    .clip(RoundedCornerShape(12.dp))
FIG. 02
同じ2つのmodifierで順序を入れ替えた例:clipの後にbackgroundを置くと角丸に沿う(左)、backgroundの後にclipを置くと角丸の外に四角い角が突き出る(右)。

(border(width, color, shape) にはこの問題はありません。明示的な形状を受け取り、常にその形状に沿ってストロークを描画するため、clipの順序には影響されません。問題になるのは、プレーンな background(color) のような形状を持たないmodifierや、Image のような生のコンテンツが、外側にある clip() の位置が正しく配置されていることに依存しているケースに限られます。)

角丸のclickableカードでリップルが四角くはみ出す

根本原因は同じです。clickable() のリップルは自分自身のノードの一部として描画されるため、clip() が clickable() の外側をラップしている場合にだけ切り取られます。逆の順序ではそうなりません。

// clipが外側、clickableが内側:リップルがclipの内側に入れ子になっているため、
// 丸い形状に切り取られる。
Modifier.clip(RoundedCornerShape(12.dp)).clickable { }
 
// clickableが外側、clipが内側:リップルはclickable自身のノードで描画され、
// それはchain内でclipの外側に位置するため、角丸を完全に無視する。
Modifier.clickable { }.clip(RoundedCornerShape(12.dp))

padding() + border() の順序でborderの位置が変わる

コンテンツだけの問題ではありません。

// borderが外側、paddingが内側:borderはfillMaxWidthいっぱいの範囲に描画され、
// paddingはその内側に入れ子になっているため、コンテンツを内側に押し込むだけ。
// borderはコンテナの端にぴったり沿う。
Modifier.fillMaxWidth().border(1.dp, Color.Gray).padding(16.dp)
 
// paddingが外側、borderが内側:borderが実行される前にpaddingが空間を縮小するため、
// border自身の範囲は既に内側にずれている。borderは端から16dp内側に位置する。
Modifier.fillMaxWidth().padding(16.dp).border(1.dp, Color.Gray)

実際に使うべきメンタルモデル

「どのプロパティを設定しているのか」と問うのはやめましょう。代わりに「このmodifierは、チェーン内で自分より左側にあるものに基づいて、サイズ、コンテンツ、タッチターゲットのうち何を入力として受け取るのか」と問いましょう。この問いだけで、毎回結果を正しく予測できます。

Keep reading

Related reads

新しい記事をメールで受け取る