Komponen Navigasi di Android Jetpack memberikan dukungan untuk aplikasi Jetpack Compose. Anda dapat bernavigasi antar-composable sekaligus memanfaatkan infrastruktur dan fitur komponen Navigasi.
Halaman ini menjelaskan perbedaan dengan Navigasi Jetpack di Compose untuk Wear OS.
Penyiapan
Gunakan dependensi berikut dalam file build.gradle modul aplikasi Anda:
Kotlin
dependencies { def wear_compose_version = "1.7.2" implementation "androidx.wear.compose:compose-navigation:$wear_compose_version" }
Ini digunakan, dan bukan artefak
androidx.navigation:navigation-compose karena menyediakan implementasi alternatif khusus untuk Wear OS.
Membuat pengontrol navigasi, host, dan grafik
Menavigasi dengan Compose untuk Wear OS memerlukan tiga komponen yang sama, yang diperlukan pada aplikasi non-Wear OS: pengontrol navigasi, host, dan grafik.
Gunakan
rememberSwipeDismissableNavController()
untuk membuat instance WearNavigator, implementasi dari NavController
yang sesuai untuk aplikasi Wear OS:
val navController = rememberSwipeDismissableNavController()
NavController adalah
API utama yang digunakan untuk menavigasi di aplikasi Compose. API ini mengontrol navigasi
antara composable dalam host navigasi yang, di Wear OS, adalah
SwipeDismissableNavHost.
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
Seperti
composable NavHost,
diperlukan referensi ke pengontrol navigasi, rute untuk tujuan
awal, dan builder untuk grafik navigasi yang ditampilkan di sini sebagai lambda akhir.
Tujuan awal harus disediakan di builder grafik navigasi, beserta semua tujuan lain yang harus dapat dijelajahi dengan pengontrol navigasi.
Di aplikasi Wear OS, deklarasikanSwipeDismissableNavHost sebagai konten
AppScaffold untuk mendukung komponen tingkat atas seperti waktu, indikator scroll atau
posisi, dan indikator halaman.
Gunakan objek AppScaffold di atas SwipeDismissableNavHost
dan ScreenScaffold di tingkat layar untuk menambahkan objek TimeText
ke layar secara default dan untuk memastikannya dianimasikan dengan benar saat menavigasi
antarlayar.
Selain itu, ScreenScaffold menambahkan PositionIndicator untuk konten yang dapat di-scroll.
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 // ...
Menampilkan dialog
Untuk menampilkan dialog menggunakan Material 3 untuk Compose di Wear OS—seperti
AlertDialog, ConfirmationDialog, OpenOnPhoneDialog,
atau Dialog—deklarasikan composable dialog langsung di dalam tujuan composable
layar yang membukanya. Untuk melakukannya, selesaikan langkah-langkah berikut:
- Kontrol visibilitas dialog menggunakan variabel status boolean, dan teruskan
status tersebut ke parameter
visibledialog. GunakanrememberSaveableatau status yang diangkat keViewModel. - Dalam callback
onDismissRequest, dan dalam callback tindakan konfirmasi atau penolakan lainnya, tetapkan variabel status kefalse. Dengan begitu, dialog akan dianimasikan dan kembali ke layar yang mendasarinya saat pengguna menggeser untuk menutup atau memilih tindakan.
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API AlertDialog, ConfirmationDialog, dan OpenOnPhoneDialog.
Untuk mempelajari Navigasi Jetpack lebih lanjut, lihat Menavigasi dengan Compose atau ikuti codelab Navigasi Jetpack Compose.
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
- Memigrasikan Jetpack Navigation ke Navigation Compose
- Navigasi dengan Compose
- Menavigasi antarlayar dengan Compose