Skip to content

佈局基礎

為了在 Compose Multiplatform 中有效地建構使用者介面,了解佈局建構的關鍵概念至關重要,包括核心原則、佈局階段,以及用於組織 UI 的常用元件和工具。

Composable 函式

您可以透過定義一系列 Composable 函式來建構使用者介面。這些函式接收資料並發出 UI 元素。@Composable 註解會告知 Compose 編譯器該函式將資料轉換為 UI。

一個顯示文字的簡單 Composable 函式:

kotlin
@Composable
fun Greeting(name: String) {
    Text(text = "Hello, $name!")
}

Column、Row 和 Box

為了組織您的佈局,您可以使用這些基本構成要素:

  • 使用 Column 在螢幕上垂直放置項目。

  • 使用 Row 在螢幕上水平放置項目。

  • 使用 Box 將元素彼此堆疊。

  • 使用 RowColumnFlowRowFlowColumn 版本來建構響應式佈局。當容器空間不足時,項目會自動流向下一行,從而建立多行或多列:

    kotlin
    @Composable
    fun ResponsiveLayout() {
        FlowRow {
            Text(text = "Item 1")
            Text(text = "Item 2")
            Text(text = "Item 3")
        }
    }

Modifiers

Modifiers 允許您以宣告式方式裝飾或調整 Composable 的行為。它們對於自訂佈局和互動至關重要,可控制尺寸、對齊、邊距、互動行為等等。

例如,您可以為文字新增邊距和置中對齊:

kotlin
@Composable
fun ModifierExample() {
    Text(
        text = "Hello with padding",
        modifier = Modifier.padding(16.dp)
    )
}

中了解更多。

後續步驟