使用 Material 3 內嵌

為方便使用，許多內建的 Material 3 可組合項 (androidx.compose.material3) 會根據可組合項在應用程式中的放置位置，自行處理插邊，符合 Material 規格。

插邊處理可組合函式

以下列出會自動處理插邊的 Material 元件。

應用程式列

• TopAppBar / SmallTopAppBar / CenterAlignedTopAppBar / MediumTopAppBar / LargeTopAppBar：將系統資訊列的頂端和水平兩側套用為邊框間距，因為這個屬性會用於視窗頂端。
• BottomAppBar：將系統資訊列的底部和水平兩側套用為邊框間距。

內容容器

• ModalDrawerSheet / DismissibleDrawerSheet / PermanentDrawerSheet (模態導覽匣內的內容)：將垂直和開始插邊套用至內容。
• ModalBottomSheet： 套用底部插邊。
• NavigationBar：套用 bottom 和 horizontal 插邊。
• 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

以下影片顯示 LazyColumn 內的 Scaffold，並停用及啟用無邊框螢幕：

一般來說，在 Scaffold 中使用 PaddingValues 參數，就足以將 UI 內嵌在系統 UI 和螢幕凹口之外。如果使用 Scaffold，請避免使用其他插邊處理方法 (例如尺規、邊框間距修飾符或插邊大小修飾符)，以免在 UI 中套用過多邊框間距。

覆寫預設插邊

您可以變更傳遞至可組合函式的 windowInsets 參數，藉此設定可組合函式的行為。這個參數可以是其他類型的視窗插邊，用來套用，也可以傳遞空白例項來停用：WindowInsets(0, 0, 0, 0)。

舉例來說，如要停用 LargeTopAppBar 的插邊處理作業，請將 windowInsets 參數設為空白執行個體：

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