ড্রপ-ডাউন মেনু ব্যবহারকারীদের কোনও আইকন, টেক্সট ফিল্ড বা অন্যান্য কম্পোনেন্টে ক্লিক করতে দেয়, এবং তারপর একটি অস্থায়ী সারফেসে বিকল্পের তালিকা থেকে বেছে নিতে দেয়। এই নির্দেশিকায় বর্ণনা করা হয়েছে কীভাবে সাধারণ মেনু এবং ডিভাইডার ও আইকন সহ আরও জটিল মেনু তৈরি করতে হয়।
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 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 = {}, ) }, ) } }
অতিরিক্ত রিসোর্স
- মেটেরিয়াল ডিজাইন: মেনু