マテリアル 3 インセットを使用する

使いやすさを考慮して、組み込みのマテリアル 3 コンポーザブル（androidx.compose.material3）の多くは、マテリアル仕様に従ってアプリにコンポーザブルが配置される方法に基づいて、インセットを自動的に処理します。

インセット処理コンポーザブル

インセットを自動的に処理するマテリアル コンポーネントは次のとおりです。

アプリバー

コンテンツ コンテナ

Scaffold

デフォルトでは、Scaffold は、使用するパラメータ PaddingValues としてインセットを提供します。Scaffold はコンテンツにインセットを適用しません。これはデベロッパーの責任です。たとえば、Scaffold 内の LazyColumn でこれらのインセットを使用するには、次のようにします。

Scaffold { innerPadding ->
    // innerPadding contains inset information for you to use and apply
    LazyColumn(
        // consume insets as scaffold doesn't do it by default
        modifier = Modifier.consumeWindowInsets(innerPadding),
        contentPadding = innerPadding
    ) {
        // ..
    }
}

次の動画は、エッジ ツー エッジ表示を無効にした場合と有効にした場合の Scaffold 内の LazyColumn を示しています。

通常は、Scaffold で PaddingValues パラメータを使用すれば、システム UI とディスプレイ カットアウトから離れた位置に UI をインセットできます。Scaffold を使用する場合は、UI に過剰なパディングが適用されないように、ルーラー、パディング修飾子、インセット サイズ修飾子などの追加のインセット処理アプローチを使用しないでください。

デフォルトのインセットをオーバーライドする

コンポーザブルに渡される windowInsets パラメータを変更して、コンポーザブルの動作を構成できます。このパラメータは、代わりに適用する別のタイプのウィンドウ インセットにすることも、空のインスタンス（WindowInsets(0, 0, 0, 0)）を渡して無効にすることもできます。

たとえば、LargeTopAppBar でインセット処理を無効にするには、windowInsets パラメータを空のインスタンスに設定します。

LargeTopAppBar(
    windowInsets = WindowInsets(0, 0, 0, 0),
    title = {
        Text("Hi")
    }
)

前へ
キーボード IME アニメーションを使用する
次へ
ビューと Compose でインセットを使用する