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

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

注: マテリアル デザイン 2 のコンポーネント（androidx.compose.material）はインセットを自動的には処理しません。ただし、インセットにアクセスして手動で適用することはできます。androidx.compose.material 1.6.0 以降では、windowInsets パラメータを使用して、BottomAppBar、TopAppBar、BottomNavigation、NavigationRail にインセットを手動で適用します。同様に、Scaffold には contentWindowInsets パラメータを使用します。別の方法としては、インセットをパディングとして手動で設定することもできます。

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

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

アプリバー

• TopAppBar / SmallTopAppBar / CenterAlignedTopAppBar / MediumTopAppBar / LargeTopAppBar: ウィンドウの上部で使用されるため、システムバーの上部と水平の辺をパディングとして適用します。
• BottomAppBar: システムバーの下部と水平の辺をパディングとして適用します。

コンテンツ コンテナ

• ModalDrawerSheet / DismissibleDrawerSheet / PermanentDrawerSheet（モーダル ナビゲーション ドロワー内のコンテンツ）: コンテンツに垂直方向と開始方向のインセットを適用します。
• ModalBottomSheet: 下インセットを適用します。
• NavigationBar : 下と水平のインセットを適用します。
• NavigationRail: vertical と start のインセットを適用します。

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
    ) {
        // ..
    }
}
InsetsSnippets.kt

次の動画は、エッジ ツー エッジ ディスプレイが無効と有効になっている Scaffold 内の LazyColumn を示しています。

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

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

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

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