মেনুগুলি

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

দুটি বিকল্প সহ ড্রপডাউন মেনু দেখানো হয়েছে। তিনটি উল্লম্ব ডট সহ আইকন নির্দেশ করে যে এটিতে ক্লিক করলে মেনু খোলে।
ছবি ১. দুটি আইটেম তালিকাভুক্ত সহ একটি বেসিক ড্রপ-ডাউন মেনু।

API সারফেস

ড্রপ-ডাউন মেনু প্রয়োগ করতে DropdownMenu, DropdownMenuItem, IconButton এবং ExposedDropdownMenuBox কম্পোনেন্ট ব্যবহার করুন। DropdownMenu এবং DropdownMenuItem কম্পোনেন্ট মেনু আইটেম দেখাতে ব্যবহার করা হয়, যেখানে IconButton বা অন্যান্য কম্পোনেন্ট মেনু ডিসপ্লে ট্রিগার করতে পারে। ExposedDropdownMenuBox-এর মাধ্যমে টেক্সট ফিল্ডের সাথে অ্যাটাচ করা মেনু তৈরি করা হয়।

DropdownMenu কম্পোনেন্টের মূল প্যারামিটারে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত থাকে:

  • expanded: মেনু দেখা যাচ্ছে কিনা তা নির্দেশ করে।
  • onDismissRequest: মেনু বাতিল করার জন্য ব্যবহার করা হয়।
  • content: মেনুর কম্পোজেবল কন্টেন্ট, সাধারণত এতে DropdownMenuItem কম্পোজেবল থাকে।

DropdownMenuItem-এর জন্য মূল প্যারামিটারে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত থাকে:

  • text: মেনু আইটেমে দেখানো কন্টেন্ট নির্ধারণ করে।
  • onClick: মেনুতে আইটেমের সাথে ইন্টার‍্যাকশন ম্যানেজ করার জন্য কলব্যাক।

একটি সাধারণ ড্রপ-ডাউন মেনু তৈরি করা

নিচের স্নিপেট থেকে বোঝা যাবে যে কীভাবে DropdownMenu-এর ন্যূনতম প্রয়োগ করা যায়:

@Composable
fun MinimalDropdownMenu() {
    var expanded by remember { mutableStateOf(false) }
    Box(
        modifier = Modifier
            .padding(16.dp)
    ) {
        IconButton(onClick = { expanded = !expanded }) {
            Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "More options")
        }
        DropdownMenu(
            expanded = expanded,
            onDismissRequest = { expanded = false }
        ) {
            DropdownMenuItem(
                text = { Text("Option 1") },
                onClick = { /* Do something... */ }
            )
            DropdownMenuItem(
                text = { Text("Option 2") },
                onClick = { /* Do something... */ }
            )
        }
    }
}

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • দুটি মেনু আইটেম সহ একটি বেসিক DropdownMenu সংজ্ঞায়িত করে।
  • expanded প্যারামিটার মেনুর দৃশ্যমানতা বড় বা ছোট করা হিসেবে নিয়ন্ত্রণ করে।
  • onDismissRequest প্যারামিটারটি একটি কলব্যাককে সংজ্ঞায়িত করে যা ব্যবহারকারী মেনু বন্ধ করলে কার্যকর হয়।
  • DropdownMenuItem কম্পোজ করার উপযুক্ত আইটেম ড্রপ-ডাউন মেনুতে বেছে নেওয়ার উপযুক্ত আইটেমকে দেখায়।
  • IconButton-এর মাধ্যমে মেনু বড় বা আড়াল করা যায়।

ফলাফল

ছবি ২. শুধুমাত্র দুটি বিকল্প সহ একটি ন্যূনতম ড্রপ-ডাউন মেনু।

আরও বড় ড্রপ-ডাউন মেনু তৈরি করুন

সব মেনু আইটেম একবারে দেখানো না গেলে, DropdownMenu সাধারণত স্ক্রল করা যায়। নিম্নলিখিত স্নিপেটটি একটি দীর্ঘ, স্ক্রোলযোগ্য ড্রপ-ডাউন মেনু তৈরি করে:

@Composable
fun LongBasicDropdownMenu() {
    var expanded by remember { mutableStateOf(false) }
    // Placeholder list of 100 strings for demonstration
    val menuItemData = List(100) { "Option ${it + 1}" }

    Box(
        modifier = Modifier
            .padding(16.dp)
    ) {
        IconButton(onClick = { expanded = !expanded }) {
            Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "More options")
        }
        DropdownMenu(
            expanded = expanded,
            onDismissRequest = { expanded = false }
        ) {
            menuItemData.forEach { option ->
                DropdownMenuItem(
                    text = { Text(option) },
                    onClick = { /* Do something... */ }
                )
            }
        }
    }
}

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • DropdownMenu স্ক্রল করা যায় যখন এর কন্টেন্টের মোট উচ্চতা উপলভ্য জায়গার থেকে বেশি হয়। এই কোডটি স্ক্রল করা যায় এমন DropdownMenu তৈরি করে যা ১০০টি প্লেসহোল্ডার আইটেম দেখায়।
  • forEach লুপ ডায়নামিকভাবে DropdownMenuItem কম্পোজেবল তৈরি করে। আইটেমগুলি লেজি পদ্ধতিতে তৈরি করা হয়নি, যার অর্থ হল ১০০টি ড্রপ-ডাউন আইটেমই তৈরি করা হয়েছে এবং কম্পোজিশনে রয়েছে।
  • IconButton-এ ক্লিক করলে DropdownMenu-এর সম্প্রসারণ এবং সঙ্কোচন ট্রিগার হয়।
  • প্রতিটি DropdownMenuItem-এর মধ্যে থাকা onClick ল্যাম্বডা আপনাকে ব্যবহারকারীর কোনও মেনু আইটেম বেছে নেওয়ার সময় সম্পন্ন করা অ্যাকশন নির্ধারণ করতে দেয়।

ফলাফল

আগের কোড স্নিপেট নিম্নলিখিত স্ক্রল করা যায় এমন মেনু তৈরি করে:

ছবি ৩. একটি দীর্ঘ, স্ক্রলযোগ্য ড্রপ-ডাউন মেনু।

ডিভাইডার সহ আরও বড় ড্রপ-ডাউন মেনু তৈরি করুন

নিম্নলিখিত স্নিপেট ড্রপ-ডাউন মেনুর আরও উন্নত প্রয়োগ দেখায়। এই স্নিপেটে, মেনু আইটেমে লিডিং ও ট্রেলিং আইকন যোগ করা হয়েছে এবং ডিভাইডার মেনু আইটেমের গ্রুপকে আলাদা করে।

@Composable
fun DropdownMenuWithDetails() {
    var expanded by remember { mutableStateOf(false) }

    Box(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp)
    ) {
        IconButton(onClick = { expanded = !expanded }) {
            Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "More options")
        }
        DropdownMenu(
            expanded = expanded,
            onDismissRequest = { expanded = false }
        ) {
            // First section
            DropdownMenuItem(
                text = { Text("Profile") },
                leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Person), contentDescription = null) },
                onClick = { /* Do something... */ }
            )
            DropdownMenuItem(
                text = { Text("Settings") },
                leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Settings), contentDescription = null) },
                onClick = { /* Do something... */ }
            )

            HorizontalDivider()

            // Second section
            DropdownMenuItem(
                text = { Text("Send Feedback") },
                leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Feedback), contentDescription = null) },
                trailingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Send), contentDescription = null) },
                onClick = { /* Do something... */ }
            )

            HorizontalDivider()

            // Third section
            DropdownMenuItem(
                text = { Text("About") },
                leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Info), contentDescription = null) },
                onClick = { /* Do something... */ }
            )
            DropdownMenuItem(
                text = { Text("Help") },
                leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Help), contentDescription = null) },
                trailingIcon = { Icon(painter = rememberVectorPainter(AppIcons.OpenInNew), contentDescription = null) },
                onClick = { /* Do something... */ }
            )
        }
    }
}

এই কোড Box-এর মধ্যে DropdownMenu-কে সংজ্ঞায়িত করে।

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • leadingIcon এবং trailingIcon প্যারামিটার DropdownMenuItem-এর শুরুতে এবং শেষে আইকন যোগ করে।
  • IconButton-এর মাধ্যমে মেনু বড় করা যায়।
  • DropdownMenu-এ একাধিক DropdownMenuItem কম্পোজেবল থাকে, যার প্রতিটি বেছে নেওয়া যায় এমন অ্যাকশনকে দেখায়।
  • HorizontalDivider কম্পোজেবল, মেনু আইটেমের গ্রুপ আলাদা করতে অনুভূমিক লাইন যোগ করে।

ফলাফল

আগের স্নিপেট আইকন ও ডিভাইডার সহ ড্রপ-ডাউন মেনু তৈরি করে:

ছবি ৪. ড্রপ-ডাউন মেনু, লিডিং ও ট্রেলিং আইকন সহ বিভিন্ন বিভাগে বিভক্ত।

M3 Expressive আপডেট

Material 3 Expressive-এ DropdownMenuPopup, DropdownMenuGroup এবং CheckableDropdownMenuItem-কে DropdownMenu এবং DropdownMenuItem-এর পাশাপাশি অতিরিক্ত বিকল্প হিসেবে যোগ করা হয়েছে যাতে গ্রুপ করা আইটেম, গ্যাপ এবং চেক করা যায় এমন স্ট্যাটাস সহ সেগমেন্ট করা মেনু তৈরি করা যায়।

M3 এক্সপ্রেসিভ মেনুর উদাহরণ।
ছবি ৫. ফাঁক (১, বাঁদিকে) এবং ডিভাইডার (২, ডানদিকে) সহ Material 3 Expressive ভার্টিক্যাল মেনুর বিভিন্নতা।

মেনুর জন্য M3 Expressive আপডেট সম্পর্কে আরও জানতে, Material Design 3 মেনু সংক্রান্ত নির্দেশিকা দেখুন।

সেগমেন্ট করা মেনু

সেগমেন্ট করা মেনু গ্রুপ সম্পর্কিত অ্যাকশনকে আলাদা ভিজ্যুয়াল বিভাগে ভাগ করে যা ফাঁকা জায়গা বা ডিভাইডার দিয়ে আলাদা করা থাকে। নিম্নলিখিত স্নিপেট থেকে বোঝা যায় যে কীভাবে DropdownMenuPopup, DropdownMenuGroup এবং CheckableDropdownMenuItem-এর সাথে সেগমেন্ট করা ড্রপ-ডাউন মেনু প্রয়োগ করা যায়:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun GroupedMenuSample() {
    val groupInteractionSource = remember { MutableInteractionSource() }
    var expanded by remember { mutableStateOf(false) }
    val groupLabels = listOf("Modification", "Navigation")
    val groupItemLabels = listOf(listOf("Edit", "Settings"), listOf("Home", "More Options"))
    val groupItemLeadingIcons =
        listOf(listOf(AppIcons.Edit, AppIcons.Settings), listOf(null, AppIcons.Info))
    val groupItemCheckedLeadingIcons =
        listOf(
            listOf(AppIcons.EditFilled, AppIcons.SettingsFilled),
            listOf(AppIcons.Check, AppIcons.InfoFilled),
        )
    val groupItemTrailingIcons: List<List<ImageVector?>> =
        listOf(listOf(null, null), listOf(AppIcons.Home, AppIcons.MoreVert))
    val groupItemCheckedTrailingIcons: List<List<ImageVector?>> =
        listOf(listOf(null, null), listOf(AppIcons.HomeFilled, AppIcons.MoreVert))
    val groupItemSupportingText: List<List<String?>> =
        listOf(listOf("Edit mode", null), listOf(null, "Opens menu"))
    val checked = remember {
        listOf(mutableStateListOf(false, false), mutableStateListOf(false, false))
    }

    Box(modifier = Modifier.fillMaxSize().wrapContentSize(Alignment.TopStart)) {
        // Icon button should have a tooltip associated with it for a11y.
        TooltipBox(
            positionProvider =
                TooltipDefaults.rememberTooltipPositionProvider(TooltipAnchorPosition.Above),
            tooltip = { PlainTooltip { Text("Localized description") } },
            state = rememberTooltipState(),
        ) {
            IconButton(onClick = { expanded = true }) {
                Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "Localized description")
            }
        }
        DropdownMenuPopup(expanded = expanded, onDismissRequest = { expanded = false }) {
            val groupCount = groupLabels.size
            groupLabels.fastForEachIndexed { groupIndex, label ->
                DropdownMenuGroup(
                    shapes = MenuDefaults.groupShape(groupIndex, groupCount),
                    interactionSource = groupInteractionSource,
                ) {
                    MenuDefaults.DropdownMenuGroupLabel { Text(label) }
                    HorizontalDivider(modifier = Modifier.padding(MenuDefaults.HorizontalDividerPadding))
                    val groupItemCount = groupItemLabels[groupIndex].size
                    groupItemLabels[groupIndex].fastForEachIndexed { itemIndex, itemLabel ->
                        CheckableDropdownMenuItem(
                            text = { Text(itemLabel) },
                            supportingText =
                                groupItemSupportingText[groupIndex][itemIndex]?.let { supportingText ->
                                    { Text(supportingText) }
                                },
                            shapes = MenuDefaults.itemShape(itemIndex, groupItemCount),
                            leadingIcon =
                                groupItemLeadingIcons[groupIndex][itemIndex]?.let { iconData ->
                                    {
                                        Icon(
                                            painter = rememberVectorPainter(iconData),
                                            modifier = Modifier.size(MenuDefaults.LeadingIconSize),
                                            contentDescription = null,
                                        )
                                    }
                                },
                            checkedLeadingIcon = {
                                Icon(
                                    painter = rememberVectorPainter(groupItemCheckedLeadingIcons[groupIndex][itemIndex]),
                                    modifier = Modifier.size(MenuDefaults.LeadingIconSize),
                                    contentDescription = null,
                                )
                            },
                            trailingContent =
                                if (checked[groupIndex][itemIndex]) {
                                    groupItemCheckedTrailingIcons[groupIndex][itemIndex]?.let { iconData ->
                                        {
                                            Icon(
                                                painter = rememberVectorPainter(iconData),
                                                modifier = Modifier.size(MenuDefaults.TrailingIconSize),
                                                contentDescription = null,
                                            )
                                        }
                                    }
                                } else {
                                    groupItemTrailingIcons[groupIndex][itemIndex]?.let { iconData ->
                                        {
                                            Icon(
                                                painter = rememberVectorPainter(iconData),
                                                modifier = Modifier.size(MenuDefaults.TrailingIconSize),
                                                contentDescription = null,
                                            )
                                        }
                                    }
                                },
                            checked = checked[groupIndex][itemIndex],
                            onCheckedChange = { checked[groupIndex][itemIndex] = it },
                        )
                    }
                }

                if (groupIndex != groupCount - 1) {
                    Spacer(Modifier.height(MenuDefaults.GroupSpacing))
                }
            }
            if (checked.last().last()) {
                DropdownMenuButtonGroup()
            }
        }
    }
}

@Composable
private fun DropdownMenuButtonGroup() {
    ButtonGroup(
        overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState) },
        modifier = Modifier.fillMaxWidth(),
        horizontalArrangement = Arrangement.spacedBy(2.dp, Alignment.CenterHorizontally),
    ) {
        customItem(
            buttonGroupContent = {
                FilledIconButton(
                    onClick = {},
                    colors =
                        IconButtonDefaults.filledIconButtonColors(
                            containerColor = MenuDefaults.groupStandardContainerColor
                        ),
                ) {
                    Icon(painter = rememberVectorPainter(AppIcons.ThumbUp), contentDescription = "Localized description")
                }
            },
            menuContent = {
                DropdownMenuItem(
                    leadingIcon = {
                        Icon(painter = rememberVectorPainter(AppIcons.ThumbUp), contentDescription = null)
                    },
                    text = { Text("Thumbs up") },
                    onClick = {},
                )
            },
        )

        customItem(
            buttonGroupContent = {
                FilledIconButton(
                    onClick = {},
                    colors =
                        IconButtonDefaults.filledIconButtonColors(
                            containerColor = MenuDefaults.groupStandardContainerColor
                        ),
                ) {
                    Icon(painter = rememberVectorPainter(AppIcons.ThumbDown), contentDescription = "Localized description")
                }
            },
            menuContent = {
                DropdownMenuItem(
                    leadingIcon = {
                        Icon(painter = rememberVectorPainter(AppIcons.ThumbDown), contentDescription = null)
                    },
                    text = { Text("Thumbs down") },
                    onClick = {},
                )
            },
        )

        customItem(
            buttonGroupContent = {
                FilledIconButton(
                    onClick = {},
                    colors =
                        IconButtonDefaults.filledIconButtonColors(
                            containerColor = MenuDefaults.groupStandardContainerColor
                        ),
                ) {
                    Icon(painter = rememberVectorPainter(AppIcons.TagFaces), contentDescription = "Localized description")
                }
            },
            menuContent = {
                DropdownMenuItem(
                    leadingIcon = {
                        Icon(painter = rememberVectorPainter(AppIcons.TagFaces), contentDescription = null)
                    },
                    text = { Text("Emotes") },
                    onClick = {},
                )
            },
        )
    }
}

অতিরিক্ত রিসোর্স

  • মেটেরিয়াল ডিজাইন: মেনু