বেশিরভাগ অ্যাপে কয়েকটি টপ-লেভেল ডেস্টিনেশন থাকে যেগুলি অ্যাপের প্রাথমিক নেভিগেশন UI-এর মাধ্যমে অ্যাক্সেস করা যায়। কমপ্যাক্ট উইন্ডোতে, যেমন স্ট্যান্ডার্ড ফোন ডিসপ্লেতে, গন্তব্যগুলি সাধারণত উইন্ডোর নিচের দিকে একটি নেভিগেশন বারে দেখানো হয়। ট্যাবলেটে ফুল স্ক্রিন অ্যাপের মতো বড় উইন্ডোতে, অ্যাপের পাশে নেভিগেশন রেল সাধারণত একটি ভালো বিকল্প, কারণ ডিভাইসের বাঁ ও ডান দিক ধরে রাখার সময় নেভিগেশন কন্ট্রোল সহজে অ্যাক্সেস করা যায়।
NavigationSuiteScaffold WindowSizeClass-এর উপর ভিত্তি করে
উপযুক্ত নেভিগেশন UI কম্পোজেবল দেখানোর মাধ্যমে নেভিগেশন UI-এর মধ্যে
সুইচ করা সহজ করে তোলে। এর মধ্যে রানটাইম উইন্ডোর সাইজ পরিবর্তন করার সময়
ডায়নামিকভাবে UI পরিবর্তন করা অন্তর্ভুক্ত। ডিফল্ট অ্যাকশন হল
নিম্নলিখিত UI কম্পোনেন্টের যেকোনও একটি দেখানো:
- নেভিগেশন বার যদি প্রস্থ বা উচ্চতা কমপ্যাক্ট হয় অথবা ডিভাইসটি টেবিলটপ ভঙ্গিতে থাকে
- অন্য সবকিছুর জন্য নেভিগেশন রেল
NavigationSuiteScaffold কম্প্যাক্ট উইন্ডোতে নেভিগেশন বার দেখায়।
NavigationSuiteScaffold বড় করা উইন্ডোতে নেভিগেশন রেল দেখায়।
ডিপেন্ডেন্সি যোগ করুন
NavigationSuiteScaffold হল
Material3 অ্যাডাপ্টিভ নেভিগেশন স্যুট
লাইব্রেরির অংশ। আপনার অ্যাপ বা মডিউলের build.gradle ফাইলে লাইব্রেরির জন্য একটি ডিপেন্ডেন্সি যোগ করুন:
Kotlin
implementation("androidx.compose.material3:material3-adaptive-navigation-suite")
গ্ৰুভি
implementation 'androidx.compose.material3:material3-adaptive-navigation-suite'
একটি স্ক্যাফোল্ড তৈরি করুন
NavigationSuiteScaffold-এর দুটি প্রধান অংশ হল নেভিগেশন স্যুট আইটেম
এবং বেছে নেওয়া গন্তব্যের কন্টেন্ট। আপনি সরাসরি কম্পোজেবলে
নেভিগেশন স্যুট আইটেমগুলি সংজ্ঞায়িত করতে পারেন, তবে এগুলি অন্য কোথাও সংজ্ঞায়িত করা সাধারণ, উদাহরণস্বরূপ, একটি enum-এ:
enum class AppDestinations( @StringRes val label: Int, val icon: ImageVector, @StringRes val contentDescription: Int ) { HOME(R.string.home, Icons.Default.Home, R.string.home), FAVORITES(R.string.favorites, Icons.Default.Favorite, R.string.favorites), SHOPPING(R.string.shopping, Icons.Default.ShoppingCart, R.string.shopping), PROFILE(R.string.profile, Icons.Default.AccountBox, R.string.profile), }
NavigationSuiteScaffold ব্যবহার করতে, আপনাকে অবশ্যই বর্তমান গন্তব্য ট্র্যাক করতে হবে, যা
আপনি rememberSaveable ব্যবহার করে করতে পারেন:
var currentDestination by rememberSaveable { mutableStateOf(AppDestinations.HOME) }
নিচের উদাহরণে, navigationSuiteItems প্যারামিটার (টাইপ
NavigationSuiteScope) কোনও নির্দিষ্ট গন্তব্যের জন্য নেভিগেশন UI নির্ধারণ করতে
তার item ফাংশন ব্যবহার করে। নেভিগেশন বার, রেল ও ড্রয়ার জুড়ে
ডেস্টিনেশন UI ব্যবহার করা হয়। নেভিগেশন আইটেম তৈরি করতে, আপনি
আপনার AppDestinations (আগের স্নিপেটে সংজ্ঞায়িত) লুপ ওভার করেন:
NavigationSuiteScaffold( navigationSuiteItems = { AppDestinations.entries.forEach { item( icon = { Icon( it.icon, contentDescription = stringResource(it.contentDescription) ) }, label = { Text(stringResource(it.label)) }, selected = it == currentDestination, onClick = { currentDestination = it } ) } } ) { // TODO: Destination content. }
গন্তব্য কন্টেন্ট ল্যাম্বডার মধ্যে, কোন UI ডিসপ্লে করা হবে তা নির্ধারণ করতে currentDestination ভ্যালু ব্যবহার করুন। আপনার অ্যাপে নেভিগেশন লাইব্রেরি ব্যবহার করলে, উপযুক্ত গন্তব্য দেখাতে
এখানে এটি ব্যবহার করুন। when স্টেটমেন্ট যথেষ্ট হতে পারে:
NavigationSuiteScaffold( navigationSuiteItems = { /*...*/ } ) { // Destination content. when (currentDestination) { AppDestinations.HOME -> HomeDestination() AppDestinations.FAVORITES -> FavoritesDestination() AppDestinations.SHOPPING -> ShoppingDestination() AppDestinations.PROFILE -> ProfileDestination() } }
রঙ পরিবর্তন করুন
NavigationSuiteScaffold পুরো এলাকা জুড়ে একটি Surface তৈরি করে
যা স্ক্যাফোল্ড দখল করে, সাধারণত পুরো উইন্ডো। এছাড়াও, স্ক্যাফোল্ড
নির্দিষ্ট নেভিগেশন UI ড্র করে, যেমন NavigationBar।
সারফেস ও নেভিগেশন UI, দুটিই আপনার অ্যাপের থিমে উল্লেখ করা ভ্যালু ব্যবহার করে, তবে আপনি থিমের ভ্যালু ওভাররাইড করতে পারবেন।
containerColor প্যারামিটার সারফেসের রঙ নির্দিষ্ট করে। ডিফল্ট
হল আপনার রঙের স্কিমের ব্যাকগ্রাউন্ডের রঙ। contentColor প্যারামিটার
সেই সারফেসের উপর কন্টেন্টের রঙ নির্দিষ্ট করে। containerColor-এর জন্য যা নির্দিষ্ট করা আছে,
ডিফল্ট হল সেটির "চালু" রঙ। যেমন, containerColor
যদি background রঙ ব্যবহার করে, তাহলে contentColor onBackground রঙ ব্যবহার করে।
কালার সিস্টেম কীভাবে কাজ করে সেই সম্পর্কে আরও জানতে
Compose-এ মেটেরিয়াল ডিজাইন ৩ থিমিং দেখুন। এইসব ভ্যালু ওভাররাইড করার সময়,
আপনার থিমে সংজ্ঞায়িত ভ্যালু ব্যবহার করুন যাতে আপনার অ্যাপ ডার্ক ও লাইট ডিসপ্লে
মোড সাপোর্ট করে:
NavigationSuiteScaffold( navigationSuiteItems = { /* ... */ }, containerColor = MaterialTheme.colorScheme.primary, contentColor = MaterialTheme.colorScheme.onPrimary, ) { // Content... }
নেভিগেশন UI, NavigationSuiteScaffold সারফেসের সামনে ড্র করা হয়।
UI রঙের ডিফল্ট ভ্যালু
NavigationSuiteDefaults.colors()-এর মাধ্যমে প্রদান করা হয়, তবে আপনি
এইসব ভ্যালু ওভাররাইডও করতে পারবেন। যেমন, আপনি যদি নেভিগেশন বারের ব্যাকগ্রাউন্ড স্বচ্ছ করতে চান,
কিন্তু অন্যান্য ভ্যালু ডিফল্ট হিসেবে রাখতে চান,
তাহলে navigationBarContainerColor ওভাররাইড করুন:
NavigationSuiteScaffold( navigationSuiteItems = { /* ... */ }, navigationSuiteColors = NavigationSuiteDefaults.colors( navigationBarContainerColor = Color.Transparent, ) ) { // Content... }
সবশেষে, আপনি নেভিগেশন UI-তে প্রতিটি আইটেম কাস্টমাইজ করতে পারবেন। item ফাংশন
কল করার সময়, আপনি
NavigationSuiteItemColors-এর ইনস্ট্যান্স পাস করতে পারবেন। ক্লাসটি নেভিগেশন বার, নেভিগেশন রেল এবং নেভিগেশন ড্রয়ারে আইটেমের রঙ নির্দিষ্ট করে। এর অর্থ হল, প্রতিটি নেভিগেশন UI ধরন জুড়ে আপনার একই রঙ থাকতে পারে,
অথবা আপনার প্রয়োজন অনুযায়ী রঙ পরিবর্তন করতে পারেন। সব আইটেমের জন্য একই অবজেক্ট ইনস্ট্যান্স ব্যবহার করতে
NavigationSuiteScaffold লেভেলে রঙ নির্ধারণ করুন
এবং আপনি শুধুমাত্র যেগুলি পরিবর্তন করতে চান
সেগুলিকে ওভাররাইড করতে NavigationSuiteDefaults.itemColors() ফাংশন কল করুন:
val myNavigationSuiteItemColors = NavigationSuiteDefaults.itemColors( navigationBarItemColors = NavigationBarItemDefaults.colors( indicatorColor = MaterialTheme.colorScheme.primaryContainer, selectedIconColor = MaterialTheme.colorScheme.onPrimaryContainer ), ) NavigationSuiteScaffold( navigationSuiteItems = { AppDestinations.entries.forEach { item( icon = { Icon( it.icon, contentDescription = stringResource(it.contentDescription) ) }, label = { Text(stringResource(it.label)) }, selected = it == currentDestination, onClick = { currentDestination = it }, colors = myNavigationSuiteItemColors, ) } }, ) { // Content... }
নেভিগেশনের ধরন কাস্টমাইজ করুন
NavigationSuiteScaffold-এর ডিফল্ট অ্যাকশন উইন্ডো সাইজ ক্লাস-এর উপর ভিত্তি করে
নেভিগেশন UI পরিবর্তন করে। তবে, আপনি এই আচরণ ওভাররাইড করতে
চাইতেই পারেন। যেমন, আপনার অ্যাপ যদি ফিডের জন্য কন্টেন্টের একটি বড় প্যান দেখায়, তাহলে অ্যাপটি বড় করা উইন্ডোর জন্য একটি স্থায়ী নেভিগেশন ড্রয়ার ব্যবহার করতে পারে তবে
কমপ্যাক্ট এবং মাঝারি উইন্ডো সাইজ ক্লাসের জন্য ডিফল্ট অ্যাকশনে ফিরে যেতে পারে:
val adaptiveInfo = currentWindowAdaptiveInfo() val customNavSuiteType = with(adaptiveInfo) { if (windowSizeClass.isWidthAtLeastBreakpoint(WIDTH_DP_EXPANDED_LOWER_BOUND)) { NavigationSuiteType.NavigationDrawer } else { NavigationSuiteScaffoldDefaults.calculateFromAdaptiveInfo(adaptiveInfo) } } NavigationSuiteScaffold( navigationSuiteItems = { /* ... */ }, layoutType = customNavSuiteType, ) { // Content... }
অতিরিক্ত রিসোর্স
মেটেরিয়াল ডিজাইন সংক্রান্ত নির্দেশিকা:
androidx.compose.material3লাইব্রেরি কম্পোনেন্ট: