แถบการนำทางช่วยให้ผู้ใช้สลับระหว่างปลายทางต่างๆ ในแอปได้ คุณควรใช้แถบการนำทางเพื่อวัตถุประสงค์ต่อไปนี้
- ปลายทาง 3-5 แห่งที่มีความสำคัญเท่ากัน
- ขนาดหน้าต่างกะทัดรัด
- ปลายทางที่สอดคล้องกันในหน้าจอแอป
หน้านี้แสดงวิธีแสดงแถบนำทางในแอปพร้อมหน้าจอที่เกี่ยวข้องและการนำทางพื้นฐาน
แพลตฟอร์ม API
ใช้ Composable NavigationBar และ NavigationBarItem เพื่อใช้ตรรกะการสลับปลายทาง NavigationBarItem แต่ละรายการแสดงถึงปลายทางเดียว
NavigationBarItem มีพารามิเตอร์หลักต่อไปนี้
selected: กำหนดว่าจะไฮไลต์รายการปัจจุบันให้เห็นชัดเจนหรือไม่onClick(): กำหนดการดำเนินการที่จะทำเมื่อผู้ใช้คลิกรายการ ตรรกะสำหรับการจัดการเหตุการณ์การนำทาง การอัปเดตสถานะรายการที่เลือก หรือการโหลดเนื้อหาที่เกี่ยวข้องจะอยู่ที่นี่label: แสดงข้อความภายในรายการ ไม่บังคับicon: แสดงไอคอนภายในรายการ ไม่บังคับ
ตัวอย่าง: แถบการไปยังส่วนต่างๆ ด้านล่าง
ข้อมูลโค้ดต่อไปนี้จะใช้แถบการไปยังส่วนต่างๆ ด้านล่างที่มีรายการเพื่อให้ผู้ใช้ไปยังหน้าจอต่างๆ ในแอปได้
@Composable fun NavigationBarExample(modifier: Modifier = Modifier) { val navController = rememberNavController() val startDestination = Destination.SONGS var selectedDestination by rememberSaveable { mutableIntStateOf(startDestination.ordinal) } Scaffold( modifier = modifier, bottomBar = { NavigationBar(windowInsets = NavigationBarDefaults.windowInsets) { Destination.entries.forEachIndexed { index, destination -> NavigationBarItem( selected = selectedDestination == index, onClick = { navController.navigate(route = destination.route) selectedDestination = index }, icon = { Icon( destination.icon, contentDescription = destination.contentDescription ) }, label = { Text(destination.label) } ) } } } ) { contentPadding -> AppNavHost(navController, startDestination, modifier = Modifier.padding(contentPadding)) } }
ข้อมูลสำคัญ
NavigationBarจะแสดงคอลเล็กชันของรายการ โดยแต่ละรายการจะสอดคล้องกับDestinationval navController = rememberNavController()สร้างและจดจำอินสแตนซ์ของNavHostControllerซึ่งจัดการการนำทางภายในNavHostvar selectedDestination by rememberSaveable { mutableIntStateOf(startDestination.ordinal) }จัดการสถานะของรายการที่เลือกstartDestination.ordinalรับดัชนีตัวเลข (ตำแหน่ง) ของรายการ enumDestination.SONGS
- เมื่อมีการคลิกรายการ ระบบจะเรียกใช้
navController.navigate(route = destination.route)เพื่อไปยังหน้าจอที่เกี่ยวข้อง - Lambda
onClickของNavigationBarItemจะอัปเดตสถานะselectedDestinationเพื่อไฮไลต์รายการที่คลิกด้วยภาพ - ตรรกะการนำทางจะเรียกใช้ Composable
AppNavHostโดยส่งnavControllerและstartDestinationเพื่อแสดงเนื้อหาจริงของหน้าจอที่เลือก
ผลลัพธ์
รูปภาพต่อไปนี้แสดงแถบนำทางที่ได้จากข้อมูลโค้ดก่อนหน้า
การอัปเดต M3 Expressive
Material 3 Expressive เปิดตัว ShortNavigationBar และ ShortNavigationBarItem เป็นตัวเลือกเพิ่มเติมที่ยืดหยุ่นควบคู่ไปกับ NavigationBar มาตรฐาน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดต M3 Expressive สำหรับแถบการนำทางได้ที่หลักเกณฑ์เกี่ยวกับแถบการนำทางของ Material Design 3
รายการการนำทางใน ShortNavigationBar สามารถจัดเรียงได้ทั้งแนวตั้งหรือแนวนอน
แถบนำทางที่มีรายการแนวตั้ง
ใช้รายการแนวตั้งในหน้าต่างขนาดเล็ก เช่น บนมือถือ ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ ShortNavigationBar กับรายการแนวตั้ง
@Composable fun ShortNavigationBarSample() { var selectedItem by remember { mutableIntStateOf(0) } val items = listOf("Songs", "Artists", "Playlists") ShortNavigationBar { items.forEachIndexed { index, item -> ShortNavigationBarItem( icon = { Icon( painter = rememberVectorPainter(if (selectedItem == index) AppIcons.FavoriteFilled else AppIcons.Favorite), contentDescription = null, ) }, label = { Text(item) }, selected = selectedItem == index, onClick = { selectedItem = index }, ) } } }
แถบนำทางที่มีรายการแนวนอน
ใช้รายการแนวนอนในหน้าต่างขนาดกลาง เช่น บนแท็บเล็ต ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ ShortNavigationBar ที่มีรายการแนวนอนอยู่ตรงกลางแถบ
@Composable fun ShortNavigationBarWithHorizontalItemsSample() { var selectedItem by remember { mutableIntStateOf(0) } val items = listOf("Songs", "Artists", "Playlists") Column { Text( "Note: this configuration is better displayed in medium screen sizes.", Modifier.padding(16.dp), ) Spacer(Modifier.height(32.dp)) ShortNavigationBar(arrangement = ShortNavigationBarArrangement.Centered) { items.forEachIndexed { index, item -> ShortNavigationBarItem( iconPosition = NavigationItemIconPosition.Start, icon = { Icon( painter = rememberVectorPainter(if (selectedItem == index) AppIcons.FavoriteFilled else AppIcons.Favorite), contentDescription = null, ) }, label = { Text(item) }, selected = selectedItem == index, onClick = { selectedItem = index }, ) } } } }