NavController
একটি "ব্যাক স্ট্যাক" ধারণ করে যাতে ব্যবহারকারীর পরিদর্শন করা গন্তব্যগুলি থাকে৷ ব্যবহারকারী আপনার অ্যাপ জুড়ে স্ক্রীনে নেভিগেট করার সাথে সাথে, NavController
পিছনের স্ট্যাকে এবং থেকে গন্তব্য যোগ করে এবং সরিয়ে দেয়।
স্ট্যাক হওয়ার ক্ষেত্রে, ব্যাক স্ট্যাক একটি "লাস্ট ইন, ফার্স্ট আউট" ডেটা স্ট্রাকচার। তাই NavController
আইটেমগুলিকে ধাক্কা দেয় এবং স্ট্যাকের উপরে থেকে আইটেমগুলিকে পপ করে।
মৌলিক আচরণ
ব্যাক স্ট্যাকের আচরণ সম্পর্কে আপনার বিবেচনা করা উচিত এই মূল তথ্য:
- প্রথম গন্তব্য: ব্যবহারকারী অ্যাপটি খুললে,
NavController
প্রথম গন্তব্যটিকে পিছনের স্ট্যাকের শীর্ষে ঠেলে দেয়। - স্ট্যাকের দিকে ঠেলে দেওয়া: প্রতিটি কল
NavController.navigate()
প্রদত্ত গন্তব্যটিকে স্ট্যাকের শীর্ষে ঠেলে দেয়। - পপিং শীর্ষ গন্তব্য: উপরে বা পিছনে ট্যাপ করা যথাক্রমে
NavController.navigateUp()
এবংNavController.popBackStack()
পদ্ধতিগুলিকে কল করে৷ তারা স্ট্যাক বন্ধ শীর্ষ গন্তব্য পপ. আপ এবং ব্যাক এর মধ্যে পার্থক্য সম্পর্কে আরও তথ্যের জন্য নেভিগেশনের নীতিগুলি দেখুন।
ফিরে পপ
NavController.popBackStack()
পদ্ধতি ব্যাক স্ট্যাকের থেকে বর্তমান গন্তব্যটি পপ করার চেষ্টা করে এবং পূর্ববর্তী গন্তব্যে নেভিগেট করে। এটি কার্যকরভাবে ব্যবহারকারীকে তাদের নেভিগেশন ইতিহাসে এক ধাপ পিছিয়ে নিয়ে যায়। এটি একটি বুলিয়ান ফেরত দেয় যা নির্দেশ করে যে এটি সফলভাবে গন্তব্যে ফিরে এসেছে কিনা।
একটি নির্দিষ্ট গন্তব্যে ফিরে যান
আপনি একটি নির্দিষ্ট গন্তব্যে নেভিগেট করতে popBackStack()
ব্যবহার করতে পারেন। এটি করার জন্য, এর ওভারলোডগুলির একটি ব্যবহার করুন। অনেকগুলি রয়েছে যা আপনাকে একটি শনাক্তকারীতে পাস করার অনুমতি দেয়, যেমন একটি পূর্ণসংখ্যা id
বা একটি স্ট্রিং route
৷ এই ওভারলোডগুলি ব্যবহারকারীকে প্রদত্ত শনাক্তকারীর সাথে যুক্ত গন্তব্যে নিয়ে যায়। সমালোচনামূলকভাবে, তারা সেই গন্তব্যের উপরে স্ট্যাকের সমস্ত কিছু পপ করে।
এই ওভারলোডগুলিও একটি inclusive
বুলিয়ান নেয়। এটি নির্ধারণ করে যে নেভিগেট করার পরে NavController
নির্দিষ্ট গন্তব্যটি ব্যাক স্ট্যাকের থেকে পপ করবে কিনা।
একটি উদাহরণের জন্য এই সংক্ষিপ্ত স্নিপেট বিবেচনা করুন:
navController.popBackStack(R.id.destinationId, true)
এখানে NavController
পূর্ণসংখ্যা আইডি destinationId
দিয়ে গন্তব্যে ফিরে আসে। inclusive
আর্গুমেন্টের মান true
হওয়ায়, NavController
পিছনের স্ট্যাক থেকে প্রদত্ত গন্তব্যকে পপ করে।
একটি ব্যর্থ পপ ফিরে হ্যান্ডেল
যখন popBackStack()
false
রিটার্ন করে, পরবর্তীকালে NavController.getCurrentDestination()
-এ একটি কল null
রিটার্ন করে। এর মানে অ্যাপটি ব্যাক স্ট্যাকের থেকে শেষ গন্তব্যটি পপ করেছে। এই ক্ষেত্রে, ব্যবহারকারী শুধুমাত্র একটি ফাঁকা স্ক্রীন দেখেন।
এটি নিম্নলিখিত ক্ষেত্রে ঘটতে পারে:
-
popBackStack()
স্ট্যাক থেকে কিছু পপ করেনি। -
popBackStack()
ব্যাক স্ট্যাক থেকে একটি গন্তব্য পপ করেছে এবং স্ট্যাকটি এখন খালি।
এটি সমাধান করতে, আপনাকে অবশ্যই একটি নতুন গন্তব্যে নেভিগেট করতে হবে বা এটি শেষ করতে আপনার কার্যকলাপে finish()
কল করতে হবে। নিম্নলিখিত স্নিপেট এটি প্রদর্শন করে:
কোটলিন
...
if (!navController.popBackStack()) {
// Call finish() on your Activity
finish()
}
জাভা
...
if (!navController.popBackStack()) {
// Call finish() on your Activity
finish();
}
একটি গন্তব্যে পপ আপ
এক গন্তব্য থেকে অন্য গন্তব্যে নেভিগেট করার সময় পিছনের স্ট্যাক থেকে গন্তব্যগুলি সরাতে, সংশ্লিষ্ট navigate()
ফাংশন কলে একটি popUpTo()
আর্গুমেন্ট যোগ করুন। popUpTo()
navigate()
করার কলের অংশ হিসাবে নেভিগেশন লাইব্রেরীকে পিছনের স্ট্যাক থেকে কিছু গন্তব্য সরিয়ে দেওয়ার নির্দেশ দেয়। প্যারামিটার মান হল পিছনের স্ট্যাকের একটি গন্তব্যের শনাক্তকারী। শনাক্তকারী একটি পূর্ণসংখ্যা id
বা স্ট্রিং route
হতে পারে।
আপনি popUpTo()
এ যে গন্তব্যটি নির্দিষ্ট করেছেন সেটিকেও ব্যাক স্ট্যাকের পপ অফ করা উচিত তা নির্দেশ করার জন্য আপনি true
মান সহ inclusive
প্যারামিটারের জন্য একটি যুক্তি অন্তর্ভুক্ত করতে পারেন।
এটিকে প্রোগ্রাম্যাটিকভাবে বাস্তবায়ন করতে, navigate()
করতে popUpTo()
পাস করুন যাতে NavOptions
সেট true
হয় inclusive
এটি রচনা এবং দৃশ্য উভয় ক্ষেত্রেই কাজ করে।
পপ আপ যখন অবস্থা সংরক্ষণ করুন
যখন আপনি একটি গন্তব্যে নেভিগেট করতে popUpTo
ব্যবহার করেন, আপনি ঐচ্ছিকভাবে ব্যাক স্ট্যাকের থেকে পপ করা সমস্ত গন্তব্যের অবস্থা সংরক্ষণ করতে পারেন।
এই বিকল্পটি সক্ষম করতে, popUpToSaveState
সংশ্লিষ্ট action
true
হিসাবে সংজ্ঞায়িত করুন বা NavController.navigate()
এ কল করুন।
যখন আপনি একটি গন্তব্যে নেভিগেট করেন, তখন আপনি destination
সম্পত্তিতে গন্তব্যের সাথে সম্পর্কিত অবস্থা স্বয়ংক্রিয়ভাবে পুনরুদ্ধার করতে restoreSaveState
true
হিসাবে সংজ্ঞায়িত করতে পারেন।
XML উদাহরণ
এখানে একটি ক্রিয়া ব্যবহার করে XML-এ popUpTo
এর একটি উদাহরণ রয়েছে:
<action
android:id="@+id/action_a_to_b"
app:destination="@id/b"
app:popUpTo="@+id/a"
app:popUpToInclusive="true"
app:restoreState=”true”
app:popUpToSaveState="true"/>
উদাহরণ রচনা করুন
নিম্নে কম্পোজে এর একটি সম্পূর্ণ উদাহরণ দেওয়া হল:
@Composable
fun MyAppNavHost(
modifier: Modifier = Modifier,
navController: NavHostController = rememberNavController(),
startDestination: String = "destination_a"
) {
NavHost(
modifier = modifier,
navController = navController,
startDestination = startDestination
) {
composable("destination_a") {
DestinationA(
onNavigateToB = {
// Pop everything up to the "destination_a" destination off the back stack before
// navigating to the "destination_b" destination
navController.navigate("destination_b") {
popUpTo("destination_a") {
inclusive = true
saveState = true
}
}
},
)
}
composable("destination_b") { DestinationB(/* ... */) }
}
}
@ Composable
fun DestinationA(onNavigateToB: () -> Unit) {
Button(onClick = onNavigateToB) {
Text("Go to A")
}
}
আরও বিস্তারিতভাবে, আপনি নিম্নলিখিত উপায়ে NavController.navigate()
কল করার পদ্ধতি পরিবর্তন করতে পারেন:
// Pop everything up to the destination_a destination off the back stack before
// navigating to the "destination_b" destination
navController.navigate("destination_b") {
popUpTo("destination_a")
}
// Pop everything up to and including the "destination_a" destination off
// the back stack before navigating to the "destination_b" destination
navController.navigate("destination_b") {
popUpTo("destination_a") { inclusive = true }
}
// Navigate to the "search” destination only if we’re not already on
// the "search" destination, avoiding multiple copies on the top of the
// back stack
navController.navigate("search") {
launchSingleTop = true
}
NavController.navigate()
এ বিকল্পগুলি পাস করার বিষয়ে সাধারণ তথ্যের জন্য, বিকল্প নির্দেশিকা সহ নেভিগেট দেখুন।
অ্যাকশন ব্যবহার করে পপ করুন
একটি ক্রিয়া ব্যবহার করে নেভিগেট করার সময়, আপনি বিকল্পভাবে ব্যাক স্ট্যাকের বাইরে অতিরিক্ত গন্তব্যগুলি পপ করতে পারেন। উদাহরণস্বরূপ, যদি আপনার অ্যাপের একটি প্রাথমিক লগইন প্রবাহ থাকে, একবার ব্যবহারকারী লগইন করলে, আপনাকে ব্যাক স্ট্যাকের থেকে লগইন-সম্পর্কিত সমস্ত গন্তব্যগুলি পপ করা উচিত যাতে ব্যাক বোতাম ব্যবহারকারীদের লগইন প্রবাহে ফিরিয়ে না নেয়।
অতিরিক্ত পড়া
আরও তথ্যের জন্য, নিম্নলিখিত পৃষ্ঠাগুলি পড়ুন:
- বৃত্তাকার নেভিগেশন : যেখানে নেভিগেশন প্রবাহ বৃত্তাকার হয় সেক্ষেত্রে আপনি কীভাবে একটি ওভারস্টাফড ব্যাক স্ট্যাক এড়াতে পারেন তা জানুন।
- ডায়ালগ গন্তব্য : আপনি কীভাবে আপনার ব্যাক স্ট্যাক পরিচালনা করেন তার জন্য ডায়ালগ গন্তব্যগুলি কীভাবে অনন্য বিবেচনার পরিচয় দেয় সে সম্পর্কে পড়ুন।