分割按鈕

分割按鈕定義了兩個按鈕組,其中前置按鈕會執行主要動作,後置按鈕則會開啟一組與情境相關的次要選項。

啟用後,結尾選單按鈕會旋轉圖示並變更形狀。分割按鈕可以單獨放置,也可以與其他大小相同的按鈕並排。

使用分割按鈕

  • 開啟選單,為使用者提供與主要動作相關的次要選項。
  • 可單獨使用,或與標準按鈕和圖示按鈕搭配使用。
  • 通常會開啟選單,但可以自訂為開啟其他元件,例如資訊卡。
  • 支援與按鈕和圖示按鈕相同的五種大小:特小 (XS)、小 (S)、中 (M)、大 (L) 和特大 (XL)。
多種尺寸和顏色樣式的分割按鈕。
圖 1. 多種尺寸和顏色樣式的分割按鈕。

範例

填滿分割按鈕

填滿式分割按鈕是高強調變體,用於重要或最終動作。下列程式碼片段使用 SplitButtonLayout 搭配 SplitButtonDefaults.LeadingButton 和 SplitButtonDefaults.TrailingButton,實作填滿的分割按鈕:

@Composable
fun FilledSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.LeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}

色調分割按鈕

色調分割按鈕是分割按鈕的中強調變化版本。下列程式碼片段在 SplitButtonLayout 中使用 SplitButtonDefaults.TonalLeadingButton 和 SplitButtonDefaults.TonalTrailingButton:

@Composable
fun TonalSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.TonalLeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TonalTrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}