زر التقسيم

يحدّد الزر المقسّم مجموعة من زرَّين، حيث يؤدي الزر الرئيسي إجراءً أساسيًا ويفتح الزر اللاحق مجموعة ثانوية من الخيارات ذات الصلة بالسياق.

عند تفعيل زر القائمة اللاحق، يدور رمزه ويتغيّر شكله. يمكن وضع الأزرار المقسّمة بمفردها أو بجانب أزرار أخرى بالحجم نفسه.

استخدام الأزرار المقسَّمة

  • يفتح قائمة لمنح المستخدمين خيارات ثانوية ذات صلة بالإجراء الأساسي.
  • تعمل بمفردها أو جنبًا إلى جنب مع الأزرار القياسية وأزرار الرموز.
  • يفتح عادةً قائمة، ولكن يمكن تخصيصه لفتح مكوّنات أخرى مثل البطاقات.
  • تتوفّر بخمسة أحجام مختلفة، مثل الأزرار والأزرار التي تتضمّن رموزًا: صغير جدًا (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,
                )
            }
        },
    )
}

زر تقسيم لوني

الزر المقسّم اللوني هو نسخة متوسطة التركيز من الزر المقسّم. يستخدم المقتطف التالي SplitButtonDefaults.TonalLeadingButton وSplitButtonDefaults.TonalTrailingButton داخل SplitButtonLayout:

@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,
                )
            }
        },
    )
}