دکمه تقسیم

دکمه تقسیم گروهی متشکل از دو دکمه را تعریف می‌کند که دکمه اول کنش اصلی را انجام می‌دهد و دکمه دوم مجموعه‌ای ثانویه از گزینه‌های مرتبط با محتوا را باز می‌کند.

وقتی فعال شود، دکمه منوی دنباله‌دار نمادش را می‌چرخاند و شکلش را تغییر می‌دهد. دکمه‌های دونیمه را می‌توان به‌تنهایی یا درکنار دکمه‌های دیگر با همان اندازه قرار داد.

استفاده از دکمه‌های دونیمه

  • منویی را باز می‌کند تا گزینه‌های ثانویه مربوط به کنش اصلی را به کاربران ارائه دهد.
  • به‌تنهایی یا درکنار دکمه‌های استاندارد و دکمه‌های نمادین کار می‌کند.
  • معمولاً منویی را باز می‌کند، اما می‌توان آن را برای باز کردن مؤلفه‌های دیگر مانند کارت‌ها سفارشی کرد.
  • از همان پنج اندازه دکمه‌ها و دکمه‌های نماد پشتیبانی می‌کند: خیلی کوچک (XS)، کوچک (S)، متوسط (M)، بزرگ (L)، و خیلی بزرگ (XL).
دکمه‌های تقسیم در اندازه‌ها و سبک‌های رنگی متعدد.
شکل ۱. دکمه‌های تقسیم در اندازه‌ها و سبک‌های رنگی متعدد.

مثال‌ها

دکمه دونیمه توپر

دکمه تقسیم‌شده توپر نوعی دکمه با تأکید زیاد است که برای کنش‌های مهم یا نهایی استفاده می‌شود. قطعه کد زیر یک دکمه تقسیم‌شده توپر را بااستفاده از 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,
                )
            }
        },
    )
}