বোতাম গ্রুপ

বোতামের গ্রুপ বোতামগুলিকে সাজায় এবং বোতাম ও আইকন বোতামে সমন্বিত আকার, গতি এবং প্রস্থের পরিবর্তন প্রয়োগ করে তাদের মধ্যে ইন্টার‍্যাকশন যোগ করে। বোতাম গ্রুপের দুটি ভেরিয়েন্ট আছে:

  1. স্ট্যান্ডার্ড বোতাম গ্রুপ: পাশাপাশি থাকা বোতামের মধ্যে ইন্টার‍্যাকশন যোগ করে যাতে প্রেস করা হলে সেগুলি একে অপরের সাথে রেসপন্ড করে।
  2. কানেক্ট করা বোতামের গ্রুপ: ব্যবহারকারীদের বিকল্প বেছে নিতে, ভিউ পরিবর্তন করতে বা পৃষ্ঠার এলিমেন্ট সাজাতে দেওয়ার জন্য টগল বোতামের গ্রুপ।
বাঁদিকে স্ট্যান্ডার্ড বোতাম গ্রুপ এবং ডানদিকে কানেক্ট করা বোতাম গ্রুপ।
ছবি ১. স্ট্যান্ডার্ড বোতাম গ্রুপ (১, বাঁদিকে) এবং কানেক্ট করা বোতাম গ্রুপ (২, ডানদিকে)।

বোতাম গ্রুপ ব্যবহার করা

  • বোতাম প্রেস বা বেছে নেওয়া হলে শেপ মর্ফিং প্রয়োগ করে।
  • কানেক্ট করা বোতাম গ্রুপ সেগমেন্ট করা বোতামকে রিপ্লেস করে।
  • সব সাইজের বোতামের সাথে কাজ করে: অতিরিক্ত ছোট (XS), ছোট (S), মাঝারি (M), বড় (L) এবং অতিরিক্ত বড় (XL)।
  • সিঙ্গেল-সিলেক্ট, মাল্টি-সিলেক্ট ও সিলেকশন-রিকোয়ার্ড প্যাটার্ন সাপোর্ট করে।
বিভিন্ন আকার ও সাইজের বোতাম সহ বোতামের গ্রুপ।
ছবি ২. বিভিন্ন আকার ও সাইজের বোতাম সহ বোতামের গ্রুপ।

স্ট্যান্ডার্ড বোতাম গ্রুপ

ButtonGroup কম্পোজেবল ব্যবহার করে বোতামগুলিকে অনুভূমিক ক্রমে সাজান, যা প্রেস করা আইটেমকে বড় করে, আশেপাশের আইটেমগুলিকে ছোট করে এবং জায়গা সীমিত হলে অতিরিক্ত আইটেমগুলিকে ওভারফ্লো মেনুতে সরিয়ে দেয়। বোতামের গ্রুপগুলি দ্বিতীয় লাইনে মোড়ানোর পরিবর্তে একটি লাইনে থাকা উচিত।

নিম্নলিখিত স্নিপেট থেকে বোঝা যাবে যে কীভাবে ওভারফ্লো মেনু ইন্ডিকেটরের সাথে স্ট্যান্ডার্ড বোতাম গ্রুপ প্রয়োগ করতে হয়:

@Composable
fun ButtonGroupSample() {
    val numButtons = 10
    ButtonGroup(
        overflowIndicator = { menuState ->
            ButtonGroupDefaults.OverflowIndicator(menuState = menuState)
        }
    ) {
        for (i in 0 until numButtons) {
            clickableItem(onClick = {}, label = "$i")
        }
    }
}

কানেক্ট করা বোতামের গ্রুপ

ToggleButton কম্পোজেবল এবং ButtonGroupDefaults কানেক্ট করা আকৃতি দিয়ে তৈরি করা সিঙ্গেল-সিলেক্ট বা মাল্টি-সিলেক্ট প্যাটার্নের জন্য কানেক্ট করা বোতাম গ্রুপ ব্যবহার করুন।

কানেক্ট করা বোতাম গ্রুপের আচরণ।
ছবি ৩. রেসপন্সিভ কানেক্ট করা বোতাম গ্রুপের আচরণ।

সিঙ্গেল-সিলেক্ট

ব্যবহারকারী যখন পারস্পরিকভাবে এক্সক্লুসিভ সেট থেকে একটি বিকল্প বেছে নেন, তখন একটি একক-নির্বাচন কানেক্ট করা বোতাম গ্রুপ ব্যবহার করুন। নিম্নলিখিত স্নিপেট ToggleButton এবং Role.RadioButton ব্যবহার করে একটি একক-নির্বাচন সংযুক্ত বোতাম গ্রুপ প্রয়োগ করে:

@Composable
fun SingleSelectConnectedButtonGroupSample() {
    val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home")
    val unCheckedIcons =
        listOf(
            AppIcons.Work,
            AppIcons.Restaurant,
            AppIcons.Coffee,
            AppIcons.Search,
            AppIcons.Home,
        )
    val checkedIcons =
        listOf(
            AppIcons.WorkFilled,
            AppIcons.Restaurant,
            AppIcons.CoffeeFilled,
            AppIcons.Search,
            AppIcons.HomeFilled,
        )
    var selectedIndex by remember { mutableIntStateOf(0) }

    FlexBox(
        modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(),
        config = {
            direction(FlexDirection.Row)
            wrap(FlexWrap.Wrap)
            columnGap(ButtonGroupDefaults.ConnectedSpaceBetween)
            rowGap(2.dp)
        },
    ) {
        options.forEachIndexed { index, label ->
            ToggleButton(
                checked = selectedIndex == index,
                onCheckedChange = { selectedIndex = index },
                shapes =
                    when (index) {
                        0 -> ButtonGroupDefaults.connectedLeadingButtonShapes()
                        options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes()
                        else -> ButtonGroupDefaults.connectedMiddleButtonShapes()
                    },
                modifier = Modifier.semantics { role = Role.RadioButton },
            ) {
                Icon(
                    painter =
                        rememberVectorPainter(
                            if (selectedIndex == index) checkedIcons[index] else unCheckedIcons[index]
                        ),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing))
                Text(label)
            }
        }
    }
}

একাধিক বিষয় বাছাই

ব্যবহারকারী যখন স্বাধীনভাবে শূন্য বা তার বেশি বিকল্প টগল করতে পারেন তখন একটি মাল্টি-সিলেক্ট কানেক্টেড বোতাম গ্রুপ ব্যবহার করুন। নিম্নলিখিত স্নিপেট ToggleButton এবং mutableStateListOf ব্যবহার করে একটি মাল্টি-সিলেক্ট কানেক্টেড বোতাম গ্রুপ প্রয়োগ করে:

@Composable
fun MultiSelectConnectedButtonGroupSample() {
    val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home")
    val unCheckedIcons =
        listOf(
            AppIcons.Work,
            AppIcons.Restaurant,
            AppIcons.Coffee,
            AppIcons.Search,
            AppIcons.Home,
        )
    val checkedIcons =
        listOf(
            AppIcons.WorkFilled,
            AppIcons.Restaurant,
            AppIcons.CoffeeFilled,
            AppIcons.Search,
            AppIcons.HomeFilled,
        )
    val checked = remember { mutableStateListOf(false, false, false, false, false) }

    FlexBox(
        modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(),
        config = {
            direction(FlexDirection.Row)
            wrap(FlexWrap.Wrap)
            columnGap(ButtonGroupDefaults.ConnectedSpaceBetween)
            rowGap(2.dp)
        },
    ) {
        options.forEachIndexed { index, label ->
            ToggleButton(
                checked = checked[index],
                onCheckedChange = { checked[index] = it },
                shapes =
                    when (index) {
                        0 -> ButtonGroupDefaults.connectedLeadingButtonShapes()
                        options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes()
                        else -> ButtonGroupDefaults.connectedMiddleButtonShapes()
                    },
            ) {
                Icon(
                    painter =
                        rememberVectorPainter(
                            if (checked[index]) checkedIcons[index] else unCheckedIcons[index]
                        ),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing))
                Text(label)
            }
        }
    }
}