Recomposed
Recomposition

リコンポジション、レイアウト、DrawScope:一つのアイデア、三つのフェーズ

Oct 4, 2026 · 6 min read

リコンポジション、レイアウト、DrawScope:一つのアイデア、三つのフェーズ

直感的な理解

スクロールのピクセルごとにリコンポーズするコンポーザブルと、再計測だけで済むコンポーザブルは、プレビュー上では同じように見えることがある。しかし実機の画面上では、片方だけがディスプレイに追従できなくなる。その違いを生むのは状態そのものではなく、どのフェーズでそれを読み取っているかだ。

すべてのフレームは三つのフェーズを通過し、それぞれが専用のスナップショットオブザーバーを持ち、そのフェーズの内部で行われた状態の読み取りに対してのみ再実行される。

  • コンポジション:何が存在するか(最もコストが高い)
  • レイアウト:どこに、どのくらいの大きさで(中程度)
  • 描画:どのピクセルか(最も安い)

このコストは三者で均等ではない。コンポジションの再実行が最もコストが高く、レイアウトは中程度、描画は最も安い。

したがって重要な問いは「この値はどこで使われているか」ではなく、「自分はどのフェーズでこれを読み取っているか」であり、それが「この読み取りが載せられる最も安いフェーズはどこか」という問いへの答えになる。

このコストの順位が重要になるのは、三つのフェーズがすべて一つの締め切りを共有しているからだ。それはディスプレイのリフレッシュクロックである。コンポジション、レイアウト、描画はすべて次ののタイミングより前に終わらなければならず、終わらなければ前のフレームが再表示される(これがフレームドロップであり、ジャンクとして見える)。

リフレッシュレートフレームあたりの予算
60 Hz16.6 ms
90 Hz11.1 ms
120 Hz8.3 ms

この共有予算は不均等に分配されている。不要なリコンポジションが最もコストが高く、不要な再レイアウトはそれより安く、不要な再描画が最も安い。

120 Hzでは三つのフェーズとGPUを合わせて合計8.3 msしかない。スクロールのピクセルごとにリコンポーズするコンポーザブルは、この予算を最初に食い尽くしてスタッターを引き起こすものだ。

Tip 1:リコンポジション、早くではなく遅く読む

// ❌ offsetPxがコンポジション時にModifierチェーンに焼き込まれる →
// 変化するたびにチェーンが再構築される → スクロールのピクセルごとにリコンポーズする
Modifier.offset(x = offsetPx.dp)
 
// ✅ offsetPxを値として渡さず、配置ラムダの内部で読み取る →
// Modifierのアイデンティティは安定したまま、配置だけが再実行される
Modifier.offset { IntOffset(0, offsetPx.roundToInt()) }

Modifier.offset(x: Dp, y: Dp) は単純な値を受け取るため、offsetPx.dp はModifierチェーンが存在する前に、コンポジション中に解決されなければならない。変化が起きるたびに新しいModifierが生成され、リコンポーズが強制される。

一方、Modifier.offset { IntOffset(...) } はラムダそのものを保持し、レイアウトフェーズの一部である配置時にのみそれを呼び出す。そのためModifierのアイデンティティは一切変化せず、コンポジションは再実行されない。同じState、画面上の同じ効果でも、どのフェーズが代償を払うかが異なる。

唯一の例外

ノードがそもそも存在するかどうか(AnimatedVisibilityのvisible)はコンポジションで決定する必要がある。レイアウトと描画は、コンポジションが既に出力したものを移動・再描画するだけしかできない。

Tip 2:レイアウト、制約は下へ、サイズは上へ、位置は親が決める

// ❌ コンポーザブルの本体で読み取る → heightPxの変化がリコンポーズを引き起こす
val heightPx = lerp(maxHeightPx, minHeightPx, collapseFraction()).roundToInt()
Modifier.layout { measurable, constraints ->
    val placeable = measurable.measure(constraints.copy(maxHeight = heightPx))
    layout(placeable.width, heightPx) {
        placeable.placeRelative(0, 0)
    }
}
 
// ✅ modifier自身のラムダ内で読み取る → 再計測だけで済み、リコンポジションは起きない
Modifier.layout { measurable, constraints ->  // constraints:自分が満たすべき箱
    val heightPx = lerp(maxHeightPx, minHeightPx, collapseFraction()).roundToInt()
    val placeable = measurable.measure(        // measurable:保留中、これを呼ぶまでサイズは決まらない
        constraints.copy(maxHeight = heightPx)   // 下に何を渡すかは自分で選ぶ(heightを固定)
    )
    layout(placeable.width, heightPx) {        // 自分のサイズを親に報告する
        placeable.placeRelative(0, 0)            // 子をどこに置くかを決めるのは自分だけ
    }
}

子は親から渡された[min, max]の箱の中でサイズを選ぶことしかできず、自分の位置を選ぶことは決してない。

Modifier.layout はレイアウトフェーズで状態を読み取るため、コストは中程度、コンポジションより安いが描画よりは高い。そのためheightPxはTip 1と同じ理由で、ラムダの内部で読み取る必要がある。そうしなければ、コラプスドラッグのピクセルごとに再計測ではなくリコンポーズが起きてしまう。

Tip 3:DrawScope、ピクセル、左上原点、中央揃えのストローク

// ❌ コンポーザブルの本体で読み取る → progressの変化がリコンポーズを引き起こす
val progress = scrollProgress()
Modifier.drawBehind {
    val stroke = 8.dp.toPx()
    // ストローク幅の半分だけ内側にずらす。そうしないと外側半分がクリップされる
    drawCircle(Color.Blue.copy(alpha = progress),
        radius = size.minDimension / 2 - stroke / 2, style = Stroke(stroke))
}
 
// ✅ drawBehind自身のラムダ内で読み取る → 再描画だけで済み、リコンポジションは起きない
Modifier.drawBehind {
    val stroke = 8.dp.toPx()
    val progress = scrollProgress()
    drawCircle(Color.Blue.copy(alpha = progress),
        radius = size.minDimension / 2 - stroke / 2, style = Stroke(stroke))
}

DrawScopeの内部では、すべてが既にピクセル単位であり、原点は左上、+yは下方向を指す。ストロークはパスの内側ではなく、パスを中心として描かれる。そのため上記のように半分の幅だけ内側にずらす必要があり、そうしないと外側半分がクリップされる。

  • drawBehind:ノード自身のコンテンツより前だけに描画し、描画パスごとに実行され、キャッシュはされない。単に何かを下に敷きたいだけなら最もシンプルな選択。
  • drawWithContent:drawContent()を自分で呼び出すため、その呼び出しを自分の描画に対してどこに置くかによって、前・後・両方という順序を自分で制御できる。
  • drawWithCache:外側のラムダはサイズ/レイアウトが変化したときだけ再実行され、フレームごとには実行されない。コストの高いオブジェクト(Brush、Path、Shader)はそこで一度だけ構築し、それらを再利用するonDrawBehind { }やonDrawWithContent { }ブロックを返せば、実際の描画ごとにそれらが再利用される。

描画は三つのフェーズの中で再実行コストが最も安いため、progressはTip 1、2と同じ理由でこれらのいずれかの内部で読み取る必要がある。ここで読み取る限り、再計測はおろかリコンポジションも一切強制されない。

他の領域でも:同じ根本原理、異なるフレームワーク

  • ブラウザのレンダリングパイプライン(CSS):スタイル再計算、レイアウト(リフロー)、ペイント、コンポジットは、名前こそ違うが同じコストの順序を持つ。transform/opacityのアニメーションはコンポジットへ直接スキップし、リフローもリペイントも発生しない。一方width/topのアニメーションはパイプライン全体を強制する。「コンポジタースレッドに留まる」というアドバイスは、本記事のTip 1と3を、Composeの文脈ではなくブラウザのDevToolsパフォーマンスのTipとして述べたものにすぎない。
  • Flutter:同じ三フェーズの分割がbuild、layout、paintと呼ばれ、markNeedsBuild()、markNeedsLayout()、markNeedsPaint()がRenderObject上の文字通り三つの無効化ノブになっている。正しい最も安いものを呼び出すという規律は、Composeの正しいフェーズで状態を読み取るという規律とまったく同じものだ。
  • 古典的なAndroid Viewシステム:invalidate()(描画のみ)とrequestLayout()(計測とレイアウト、その後描画)の区別は、Tip 2と3の区別の直接の先祖であり、コンポジションフェーズが存在しない点だけが異なる。これはViewシステムがそもそも宣言的に設計されていなかったためだ。
  • UIKit:setNeedsDisplay()とsetNeedsLayout()の区別も同じ線を引いているが、上記の古典的なViewシステムと同様、コンポジションフェーズが存在しない。
  • SwiftUI:同じ三フェーズの分割が、body再評価(コンポジション)、LayoutプロトコルのsizeThatFits/placeSubviews(レイアウト)、CanvasのGraphicsContext(描画)として存在し、同じピクセル空間、左上原点、DrawScopeと同じ中央揃えストロークの落とし穴まで共通している。Tip 1の「早くではなく遅く読む」はAnimatableに直接対応するものがある。ShapeやViewModifierはvar animatableDataを宣言し、SwiftUIはそれを補間してレイアウト/描画を通じてフレームごとに再レンダリングし、bodyを再呼び出しすることは一切ない。
Keep reading

Related reads

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