مؤلفه پیمایش در Android Jetpack از برنامههای Jetpack Compose پشتیبانی میکند. میتوانید بین composableها پیمایش کنید و درعینحال از زیرساخت و ویژگیهای مؤلفه Navigation بهره ببرید.
این صفحه تفاوتهای Jetpack Navigation در Compose for Wear OS را شرح میدهد.
راهاندازی
از وابستگی زیر در فایل build.gradle واحد برنامهتان استفاده کنید:
کاتلین
dependencies { def wear_compose_version = "1.7.2" implementation "androidx.wear.compose:compose-navigation:$wear_compose_version" }
این مورد بهجای مصنوع androidx.navigation:navigation-compose استفاده میشود زیرا پیادهسازیهای جایگزین مختص Wear OS را ارائه میدهد.
ایجاد کنترلکننده، میزبان، و گراف پیمایش
ناوبری با Compose برای Wear OS به همان سه مؤلفه موردنیاز در برنامههای غیر Wear OS نیاز دارد: کنترلکننده ناوبری، میزبان، و نمودار.
از
rememberSwipeDismissableNavController()
برای ایجاد نمونهای از WearNavigator، پیادهسازی NavController
مناسب برای برنامههای Wear OS استفاده کنید:
val navController = rememberSwipeDismissableNavController()
NavController
میانای برنامهسازی کاربردی اصلی مورداستفاده برای پیمایش در برنامههای Compose است. این کنترلر پیمایش بین composableها را در میزبان پیمایش کنترل میکند که در Wear OS،
SwipeDismissableNavHost است.
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
Like the
NavHost composable,
it takes a reference to the navigation controller, the route for the start
destination, and the builder for the navigation graph which is shown here as a
trailing lambda.
مقصد شروع باید در سازنده نمودار ناوبری، همراه با همه مقصدهای دیگری که باید با کنترلکننده ناوبری قابلناوبری باشند، ارائه شود.
در برنامه Wear OS،SwipeDismissableNavHost را بهعنوان محتوای
AppScaffold اعلام کنید تا از مؤلفههای سطح بالا مثل زمان، پیمایش یا
نشانگر موقعیت، و نشانگر صفحه پشتیبانی شود.
از شیء AppScaffold بالای SwipeDismissableNavHost
و ScreenScaffold در سطح صفحه استفاده کنید تا شیء TimeText را بهطور پیشفرض به صفحه اضافه کنید و مطمئن شوید که هنگام پیمایش بین صفحهها بهدرستی پویانمایی میشود.
علاوهبراین، ScreenScaffold یک PositionIndicator برای محتوای پیمایشکردنی اضافه میکند.
AppScaffold { val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { composable("message_list") { MessageList(onMessageClick = { id -> navController.navigate("message_detail/$id") }) } composable("message_detail/{id}") { MessageDetail(id = it.arguments?.getString("id")!!) } } } } // Implementation of one of the screens in the navigation @Composable fun MessageDetail(id: String) { // .. Screen level content goes here val scrollState = rememberTransformingLazyColumnState() val transformationSpec = rememberTransformationSpec() ScreenScaffold( scrollState = scrollState, ) { contentPadding -> // Screen content goes here // ...
نمایش کادرهای گفتگو
برای نمایش کادر گفتگو بااستفاده از Material 3 برای Compose در Wear OS (مثل
AlertDialog، ConfirmationDialog، OpenOnPhoneDialog،
یا Dialog)، کادر گفتگوی قابلساخت را مستقیماً در مقصد قابلساخت صفحه
که آن را باز میکند اعلام کنید. برای انجام این کار، این مراحل را تکمیل کنید:
- رؤیتپذیری کادر گفتگو را بااستفاده از متغیر حالت بولی کنترل کنید و آن حالت را به پارامتر
visibleکادر گفتگو ارسال کنید. ازrememberSaveableیا وضعیتی که بهViewModelارتقا یافته است استفاده کنید. - در فراخوانی برگشتی
onDismissRequestو در هر فراخوانی برگشتی کنش تأیید یا رد کردن دیگری، متغیر وضعیت را رویfalseتنظیم کنید. به این ترتیب، وقتی کاربر برای رد کردن تند میکشد یا کنشی را انتخاب میکند، کادر گفتوگو با پویانمایی بسته میشود و به صفحه زیرین برمیگردد.
برای اطلاعات بیشتر، به اسناد مرجع میانای برنامهسازی کاربردی AlertDialog، ConfirmationDialog،
و OpenOnPhoneDialog مراجعه کنید.
برای کسب اطلاعات بیشتر درباره Jetpack Navigation، به پیمایش با Compose مراجعه کنید یا کد آزمایشگاهی Jetpack Compose Navigation را ببینید.
توصیهشده برای شما
- توجه: وقتی جاوا اسکریپت خاموش باشد، نوشتار پیوند نمایش داده میشود
- انتقال دادن Jetpack Navigation به Navigation Compose
- پیمایش با Compose
- پیمایش کردن بین صفحهها با Compose