แถบแอปคือคอนเทนเนอร์ที่ช่วยให้ผู้ใช้เข้าถึงฟีเจอร์หลักและรายการการนำทางได้ แถบแอปมี 2 ประเภท ได้แก่ แถบแอปด้านบนและแถบแอปด้านล่าง ลักษณะและวัตถุประสงค์ของแต่ละประเภทมีดังนี้
ประเภท |
ลักษณะที่ปรากฏ |
วัตถุประสงค์ |
|---|---|---|
แถบแอปด้านบน |
ที่ด้านบนของหน้าจอ |
ให้สิทธิ์เข้าถึงงานและข้อมูลสำคัญ โดยทั่วไปจะประกอบด้วยชื่อ รายการการทำงานหลัก และรายการการนำทางบางรายการ |
แถบแอปด้านล่าง |
ที่ด้านล่างของหน้าจอ |
โดยปกติแล้วจะมีรายการการนำทางหลัก นอกจากนี้ยังอาจให้สิทธิ์เข้าถึงการดำเนินการสำคัญอื่นๆ เช่น ผ่านปุ่มการทำงานแบบลอยที่มีอยู่ |
หากต้องการใช้แถบแอปด้านบนและแถบแอปด้านล่าง ให้ใช้ฟังก์ชันที่ประกอบกันได้ TopAppBar และ BottomAppBar ตามลำดับ ซึ่งช่วยให้คุณสร้างอินเทอร์เฟซที่สอดคล้องกันซึ่งรวมการควบคุมการนำทางและการดำเนินการไว้ด้วยกัน และสอดคล้องกับหลักการของ Material Design
แถบแอปด้านบน
ตารางต่อไปนี้แสดงแถบแอปด้านบน 4 ประเภท
ประเภท |
ตัวอย่าง |
|---|---|
เล็ก: สำหรับหน้าจอที่ไม่ต้องมีการนำทางหรือการดำเนินการมากนัก |
|
จัดกึ่งกลาง: สำหรับหน้าจอที่มีการดำเนินการหลักเพียงรายการเดียว |
|
ปานกลาง: สำหรับหน้าจอที่ต้องมีการนำทางและการดำเนินการในระดับปานกลาง |
|
ขนาดใหญ่: สำหรับหน้าจอที่ต้องมีการนำทางและการดำเนินการจำนวนมาก |
|
แพลตฟอร์ม API
Composable ต่างๆ ที่ช่วยให้คุณใช้แถบแอปด้านบนที่แตกต่างกัน 4 แถบนั้นค่อนข้างคล้ายกัน โดยมีพารามิเตอร์หลักหลายรายการร่วมกัน ดังนี้
title: ข้อความที่ปรากฏในแถบแอปnavigationIcon: ไอคอนหลักสำหรับการนำทาง ปรากฏทางด้านซ้ายของแถบแอปactions: ไอคอนที่ช่วยให้ผู้ใช้เข้าถึงการดำเนินการที่สำคัญได้ ซึ่งจะปรากฏที่ด้านขวาของแถบแอปscrollBehavior: กำหนดวิธีที่แถบแอปด้านบนตอบสนองต่อการเลื่อนเนื้อหาภายในของ Scaffoldcolors: กำหนดลักษณะที่แถบแอปปรากฏ
ลักษณะการเลื่อน
คุณสามารถควบคุมวิธีที่แถบแอปตอบสนองเมื่อผู้ใช้เลื่อนเนื้อหาภายในของ Scaffold ที่ระบุ โดยสร้างอินสแตนซ์ของ TopAppBarScrollBehavior แล้วส่งไปยังแถบแอปด้านบนสำหรับพารามิเตอร์ scrollBehavior
TopAppBarScrollBehavior มี 3 ประเภท ซึ่งมีดังต่อไปนี้
enterAlwaysScrollBehavior: เมื่อผู้ใช้ดึงเนื้อหาด้านในของ Scaffold ขึ้น แถบแอปด้านบนจะยุบลง แถบแอปจะขยายเมื่อผู้ใช้เริ่มดึงเนื้อหาด้านในลงมาexitUntilCollapsedScrollBehavior: คล้ายกับenterAlwaysScrollBehaviorแม้ว่าแถบแอปจะขยายเมื่อผู้ใช้ดึงเนื้อหาลงมาจนสุดเท่านั้นpinnedScrollBehavior: แถบแอปจะยังคงอยู่ที่เดิมและไม่ตอบสนองต่อการเลื่อน
ตัวอย่างต่อไปนี้ใช้ตัวเลือกเหล่านี้หลายรายการ
ตัวอย่าง
ส่วนต่อไปนี้จะแสดงการติดตั้งใช้งานแถบแอปด้านบน 4 ประเภทที่แตกต่างกัน รวมถึงตัวอย่างต่างๆ ของวิธีควบคุมลักษณะการเลื่อน
เล็ก
หากต้องการสร้างแถบแอปด้านบนขนาดเล็ก ให้ใช้คอมโพสิเบิล TopAppBar ตัวอย่างต่อไปนี้ใช้แถบแอปด้านบนแบบพื้นฐานที่มีเฉพาะชื่อ
ตัวอย่างต่อไปนี้ไม่ได้ส่งค่า TopAppBar สำหรับ scrollBehavior จึงไม่ตอบสนองต่อการเลื่อนเนื้อหาภายใน
@Composable fun SmallTopAppBarExample() { Scaffold( topBar = { TopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text("Small Top App Bar") } ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
การใช้งานนี้จะปรากฏดังนี้
จัดกึ่งกลาง
แถบแอปด้านบนที่จัดแนวตรงกลางนั้นเหมือนกับแถบแอปขนาดเล็ก
แต่ชื่อจะอยู่ตรงกลางภายในคอมโพเนนต์ หากต้องการใช้ ให้ใช้ Composable CenterAlignedTopAppBar โดยเฉพาะ
ตัวอย่างนี้ใช้ enterAlwaysScrollBehavior() เพื่อรับค่าที่ส่งสำหรับ scrollBehavior ดังนั้น แถบจะยุบเมื่อผู้ใช้เลื่อนเนื้อหาด้านในของ Scaffold
@Composable fun CenterAlignedTopAppBarExample() { val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState()) Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { CenterAlignedTopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text( "Centered Top App Bar", maxLines = 1, overflow = TextOverflow.Ellipsis ) }, navigationIcon = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description" ) } }, actions = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Menu), contentDescription = "Localized description" ) } }, scrollBehavior = scrollBehavior, ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
การใช้งานนี้จะปรากฏดังนี้
ปานกลาง
แถบแอปด้านบนขนาดกลางจะวางชื่อไว้ใต้ไอคอนเพิ่มเติม หากต้องการสร้าง ให้ใช้ Composable MediumTopAppBar
ตัวอย่างนี้ใช้ enterAlwaysScrollBehavior() เพื่อรับค่าที่ส่งสำหรับ scrollBehavior เช่นเดียวกับข้อมูลโค้ดก่อนหน้า
@Composable fun MediumTopAppBarExample() { val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior(rememberTopAppBarState()) Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { MediumTopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text( "Medium Top App Bar", maxLines = 1, overflow = TextOverflow.Ellipsis ) }, navigationIcon = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description" ) } }, actions = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Menu), contentDescription = "Localized description" ) } }, scrollBehavior = scrollBehavior ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
การใช้งานนี้จะปรากฏดังนี้ พร้อมการสาธิตลักษณะการเลื่อนจาก enterAlwaysScrollBehavior()
ใหญ่
แถบแอปด้านบนขนาดใหญ่จะคล้ายกับขนาดกลาง แต่ระยะห่างจากขอบระหว่างชื่อและไอคอนจะมากกว่า และใช้พื้นที่บนหน้าจอโดยรวมมากกว่า หากต้องการสร้าง ให้ใช้ Composable LargeTopAppBar
ตัวอย่างนี้ใช้ exitUntilCollapsedScrollBehavior() เพื่อรับค่าที่ส่งสำหรับ scrollBehavior ซึ่งแตกต่างจากข้อมูลโค้ดก่อนหน้า ดังนั้น แถบจะยุบเมื่อผู้ใช้เลื่อนเนื้อหาภายในของ Scaffold แต่จะขยายเมื่อผู้ใช้เลื่อนไปจนถึงส่วนท้ายของเนื้อหาภายใน
@Composable fun LargeTopAppBarExample() { val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior(rememberTopAppBarState()) Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { LargeTopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text( "Large Top App Bar", maxLines = 1, overflow = TextOverflow.Ellipsis ) }, navigationIcon = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description" ) } }, actions = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Menu), contentDescription = "Localized description" ) } }, scrollBehavior = scrollBehavior ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
การใช้งานนี้จะปรากฏดังนี้
การอัปเดต M3 Expressive
แถบแอปขนาดกลางที่ยืดหยุ่นและขนาดใหญ่ที่ยืดหยุ่นใหม่มาพร้อมกับการปรับปรุงที่สำคัญ เช่น ความสูงที่ยืดหยุ่น การรองรับหลายบรรทัด และข้อความที่จัดกึ่งกลาง นอกจากนี้ยังสามารถมีองค์ประกอบที่หลากหลายมากขึ้น เช่น รูปภาพ เราขอแนะนำให้ใช้แถบแอปแบบยืดหยุ่นขนาดกลางและขนาดใหญ่แทนแถบแอปขนาดกลางและขนาดใหญ่ แถบแอปขนาดเล็กได้รับการอัปเดตด้วยการปรับปรุงที่ยืดหยุ่นแบบเดียวกัน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดต M3 Expressive สำหรับแถบแอปได้ที่หลักเกณฑ์เกี่ยวกับแถบแอปของ Material Design 3
การจัดกึ่งกลางและชิดซ้าย
| เล็ก | ![]() |
|---|---|
![]() |
|
| ปานกลาง |
![]() |
![]() |
|
| ใหญ่ | ![]() |
![]() |
บรรทัดแรกขนาดเล็ก ขนาดกลางแบบยืดหยุ่น และขนาดใหญ่แบบยืดหยุ่นสามารถจัดชิดขอบด้านหน้าหรือจัดกึ่งกลางได้
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้แถบแอปด้านบนที่จัดกึ่งกลางพร้อมคำบรรยาย
@OptIn(ExperimentalMaterial3Api::class) @Composable fun SimpleCenterAlignedTopAppBarWithSubtitle() { val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { TopAppBar( title = { Text("Simple TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, titleHorizontalAlignment = Alignment.CenterHorizontally, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
ลักษณะการเลื่อน
ป้อนเสมอ
เมื่อผู้ใช้เลื่อนดูเนื้อหาลง (ดึงเนื้อหาขึ้น) แถบแอปจะยุบลงทันที เมื่อผู้ใช้เลื่อนกลับขึ้นไป (ดึงเนื้อหาลง) แถบแอปจะขยายทันที ไม่ว่าผู้ใช้จะอยู่ในรายการเนื้อหาที่เลื่อนได้ตรงไหนก็ตาม
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้แถบแอปด้านบนที่มีลักษณะการเลื่อนแบบ "เข้าเสมอ"
@OptIn(ExperimentalMaterial3Api::class) @Composable fun EnterAlwaysTopAppBar() { val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { TopAppBar( title = { Text("TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
วิดีโอต่อไปนี้แสดงผลลัพธ์ของข้อมูลโค้ดก่อนหน้า
ออกจนกว่าจะยุบ
เมื่อผู้ใช้เลื่อนเนื้อหาลง (ดึงเนื้อหาขึ้น) แถบแอปที่ยืดหยุ่นขนาดกลางและขนาดใหญ่จะยุบลงจนเหลือเพียงแถบแอปที่ยุบแล้วเท่านั้นที่มองเห็นได้ เมื่อผู้ใช้เลื่อนกลับขึ้นไป (ดึงเนื้อหาลง) แถบแอปจะยังคงยุบอยู่จนกว่าผู้ใช้จะเลื่อนไปถึงด้านบนของเนื้อหา ซึ่งแถบแอปจะขยายกลับไปเป็นความสูงเต็ม โดยมีคำบรรยายอยู่ตรงกลาง
ยืดหยุ่นปานกลาง
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้แถบแอปด้านบนแบบยืดหยุ่นขนาดกลางที่มีลักษณะการเลื่อนแบบ exit-until-collapsed
@OptIn(ExperimentalMaterial3Api::class) @Composable fun ExitUntilCollapsedCenterAlignedMediumFlexibleTopAppBar() { val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { MediumFlexibleTopAppBar( title = { Text("Medium TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, titleHorizontalAlignment = Alignment.CenterHorizontally, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
วิดีโอต่อไปนี้แสดงผลลัพธ์ของข้อมูลโค้ดก่อนหน้า
ยืดหยุ่นขนาดใหญ่
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้แถบแอปด้านบนขนาดใหญ่ที่ยืดหยุ่นซึ่งมีลักษณะการเลื่อนแบบออกจนกว่าจะยุบ
@OptIn(ExperimentalMaterial3Api::class) @Composable fun ExitUntilCollapsedCenterAlignedLargeFlexibleTopAppBar() { val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { LargeFlexibleTopAppBar( title = { Text("Large TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, titleHorizontalAlignment = Alignment.CenterHorizontally, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
วิดีโอต่อไปนี้แสดงผลลัพธ์ของข้อมูลโค้ดก่อนหน้า
แถบแอปด้านล่าง
หากต้องการสร้างแถบแอปด้านล่าง ให้ใช้ BottomAppBar Composable การใช้ Composable นี้คล้ายกับ Composable แถบแอปด้านบนที่อธิบายไว้ในส่วนก่อนหน้าของหน้านี้ คุณส่งฟังก์ชันที่ประกอบกันได้สำหรับพารามิเตอร์หลักต่อไปนี้
actions: ชุดไอคอนที่ปรากฏทางด้านซ้ายของแถบ โดยทั่วไปแล้ว ปุ่มเหล่านี้จะเป็นการดำเนินการหลักสำหรับหน้าจอที่ระบุหรือรายการการนำทางfloatingActionButton: ปุ่มการทำงานแบบลอยที่ปรากฏทางด้านขวาของแถบ
@Composable fun BottomAppBarExample() { Scaffold( bottomBar = { BottomAppBar( actions = { IconButton(onClick = { /* do something */ }) { Icon(painter = rememberVectorPainter(AppIcons.Check), contentDescription = "Localized description") } IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Localized description", ) } IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Mic), contentDescription = "Localized description", ) } IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Image), contentDescription = "Localized description", ) } }, floatingActionButton = { FloatingActionButton( onClick = { /* do something */ }, containerColor = BottomAppBarDefaults.bottomAppBarFabColor, elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation() ) { Icon(painter = rememberVectorPainter(AppIcons.Add), "Localized description") } } ) }, ) { innerPadding -> Text( modifier = Modifier.padding(innerPadding), text = "Example of a scaffold with a bottom app bar." ) } }
การใช้งานนี้จะปรากฏดังนี้
การอัปเดต M3 Expressive
สำหรับ Material 3 Expressive ให้ใช้แถบเครื่องมือที่เชื่อมต่ออยู่ (FlexibleBottomAppBar) แทนแถบแอปด้านล่างมาตรฐานเพื่อให้มีความสูงน้อยลงและจัดเรียงรายการในแนวนอนได้ยืดหยุ่นมากขึ้น
ข้อมูลโค้ดต่อไปนี้จะใช้ FlexibleBottomAppBar กับ AppBarRow ที่ย้ายรายการการดำเนินการเพิ่มเติมไปยังเมนูรายการเพิ่มเติมเมื่อมีพื้นที่จำกัด
@Composable fun FlexibleBottomAppBarSample() { val icons = listOf( AppIcons.ArrowBack, AppIcons.ArrowForward, AppIcons.Add, AppIcons.Check, AppIcons.Edit, AppIcons.Favorite, ) val items = listOf("Back", "Forward", "Add", "Check", "Edit", "Favorite") FlexibleBottomAppBar( contentPadding = PaddingValues(horizontal = 96.dp), horizontalArrangement = BottomAppBarDefaults.FlexibleFixedHorizontalArrangement, ) { AppBarRow( overflowIndicator = { menuState -> IconButton( onClick = { if (menuState.isShowing) { menuState.dismiss() } else { menuState.show() } } ) { Icon( painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "Overflow", ) } } ) { items.forEachIndexed { index, item -> clickableItem( onClick = { /* doSomething() */ }, icon = { Icon( painter = rememberVectorPainter(icons[index]), contentDescription = item, ) }, label = item, ) } } } }





