แถบแอป

แถบแอปคือคอนเทนเนอร์ที่ช่วยให้ผู้ใช้เข้าถึงฟีเจอร์หลักและรายการการนำทางได้ แถบแอปมี 2 ประเภท ได้แก่ แถบแอปด้านบนและแถบแอปด้านล่าง ลักษณะและวัตถุประสงค์ของแต่ละประเภทมีดังนี้

ประเภท

ลักษณะที่ปรากฏ

วัตถุประสงค์

แถบแอปด้านบน

ที่ด้านบนของหน้าจอ

ให้สิทธิ์เข้าถึงงานและข้อมูลสำคัญ โดยทั่วไปจะประกอบด้วยชื่อ รายการการทำงานหลัก และรายการการนำทางบางรายการ

แถบแอปด้านล่าง

ที่ด้านล่างของหน้าจอ

โดยปกติแล้วจะมีรายการการนำทางหลัก นอกจากนี้ยังอาจให้สิทธิ์เข้าถึงการดำเนินการสำคัญอื่นๆ เช่น ผ่านปุ่มการทำงานแบบลอยที่มีอยู่

ตัวอย่างแถบแอปด้านบนและด้านล่าง
รูปที่ 1 แถบแอปด้านบน (ซ้าย) และแถบแอปด้านล่าง (ขวา)

หากต้องการใช้แถบแอปด้านบนและแถบแอปด้านล่าง ให้ใช้ฟังก์ชันที่ประกอบกันได้ TopAppBar และ BottomAppBar ตามลำดับ ซึ่งช่วยให้คุณสร้างอินเทอร์เฟซที่สอดคล้องกันซึ่งรวมการควบคุมการนำทางและการดำเนินการไว้ด้วยกัน และสอดคล้องกับหลักการของ Material Design

แถบแอปด้านบน

ตารางต่อไปนี้แสดงแถบแอปด้านบน 4 ประเภท

ประเภท

ตัวอย่าง

เล็ก: สำหรับหน้าจอที่ไม่ต้องมีการนำทางหรือการดำเนินการมากนัก

แถบแอปด้านบนขนาดเล็ก

จัดกึ่งกลาง: สำหรับหน้าจอที่มีการดำเนินการหลักเพียงรายการเดียว

แถบแอปด้านบนแบบจัดกึ่งกลาง

ปานกลาง: สำหรับหน้าจอที่ต้องมีการนำทางและการดำเนินการในระดับปานกลาง

แถบแอปด้านบนขนาดกลาง

ขนาดใหญ่: สำหรับหน้าจอที่ต้องมีการนำทางและการดำเนินการจำนวนมาก

แถบแอปด้านบนขนาดใหญ่

แพลตฟอร์ม API

Composable ต่างๆ ที่ช่วยให้คุณใช้แถบแอปด้านบนที่แตกต่างกัน 4 แถบนั้นค่อนข้างคล้ายกัน โดยมีพารามิเตอร์หลักหลายรายการร่วมกัน ดังนี้

  • title: ข้อความที่ปรากฏในแถบแอป
  • navigationIcon: ไอคอนหลักสำหรับการนำทาง ปรากฏทางด้านซ้ายของแถบแอป
  • actions: ไอคอนที่ช่วยให้ผู้ใช้เข้าถึงการดำเนินการที่สำคัญได้ ซึ่งจะปรากฏที่ด้านขวาของแถบแอป
  • scrollBehavior: กำหนดวิธีที่แถบแอปด้านบนตอบสนองต่อการเลื่อนเนื้อหาภายในของ Scaffold
  • colors: กำหนดลักษณะที่แถบแอปปรากฏ

ลักษณะการเลื่อน

คุณสามารถควบคุมวิธีที่แถบแอปตอบสนองเมื่อผู้ใช้เลื่อนเนื้อหาภายในของ 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)
    }
}

การใช้งานนี้จะปรากฏดังนี้

รูปที่ 2 แถบแอปด้านบนขนาดเล็ก

จัดกึ่งกลาง

แถบแอปด้านบนที่จัดแนวตรงกลางนั้นเหมือนกับแถบแอปขนาดเล็ก แต่ชื่อจะอยู่ตรงกลางภายในคอมโพเนนต์ หากต้องการใช้ ให้ใช้ 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)
    }
}

การใช้งานนี้จะปรากฏดังนี้

รูปที่ 3 แถบแอปด้านบนที่จัดกึ่งกลาง

ปานกลาง

แถบแอปด้านบนขนาดกลางจะวางชื่อไว้ใต้ไอคอนเพิ่มเติม หากต้องการสร้าง ให้ใช้ 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()

รูปที่ 4 แถบแอปด้านบนขนาดกลางที่ยุบเมื่อผู้ใช้เลื่อนขึ้นและขยายเมื่อผู้ใช้เลื่อนลง

ใหญ่

แถบแอปด้านบนขนาดใหญ่จะคล้ายกับขนาดกลาง แต่ระยะห่างจากขอบระหว่างชื่อและไอคอนจะมากกว่า และใช้พื้นที่บนหน้าจอโดยรวมมากกว่า หากต้องการสร้าง ให้ใช้ 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)
    }
}

การใช้งานนี้จะปรากฏดังนี้

รูปที่ 5 ตัวอย่างการติดตั้งใช้งานแถบแอปด้านบนขนาดใหญ่

การอัปเดต M3 Expressive

แถบแอปขนาดกลางที่ยืดหยุ่นและขนาดใหญ่ที่ยืดหยุ่นใหม่มาพร้อมกับการปรับปรุงที่สำคัญ เช่น ความสูงที่ยืดหยุ่น การรองรับหลายบรรทัด และข้อความที่จัดกึ่งกลาง นอกจากนี้ยังสามารถมีองค์ประกอบที่หลากหลายมากขึ้น เช่น รูปภาพ เราขอแนะนำให้ใช้แถบแอปแบบยืดหยุ่นขนาดกลางและขนาดใหญ่แทนแถบแอปขนาดกลางและขนาดใหญ่ แถบแอปขนาดเล็กได้รับการอัปเดตด้วยการปรับปรุงที่ยืดหยุ่นแบบเดียวกัน

แถบแอปด้านบนที่มีสไตล์ที่สื่ออารมณ์
รูปที่ 6 รูปแบบต่างๆ ของแถบแอปด้านบนแบบสื่ออารมณ์ของ M3

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดต 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 ->
            // ...
        },
    )
}

วิดีโอต่อไปนี้แสดงผลลัพธ์ของข้อมูลโค้ดก่อนหน้า

รูปที่ 7 แถบแอปด้านบนที่มีลักษณะการเลื่อนแบบเข้าเสมอ ซึ่งจะยุบเมื่อผู้ใช้เลื่อนลงและขยายเมื่อผู้ใช้เลื่อนขึ้น

ออกจนกว่าจะยุบ

เมื่อผู้ใช้เลื่อนเนื้อหาลง (ดึงเนื้อหาขึ้น) แถบแอปที่ยืดหยุ่นขนาดกลางและขนาดใหญ่จะยุบลงจนเหลือเพียงแถบแอปที่ยุบแล้วเท่านั้นที่มองเห็นได้ เมื่อผู้ใช้เลื่อนกลับขึ้นไป (ดึงเนื้อหาลง) แถบแอปจะยังคงยุบอยู่จนกว่าผู้ใช้จะเลื่อนไปถึงด้านบนของเนื้อหา ซึ่งแถบแอปจะขยายกลับไปเป็นความสูงเต็ม โดยมีคำบรรยายอยู่ตรงกลาง

ยืดหยุ่นปานกลาง

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้แถบแอปด้านบนแบบยืดหยุ่นขนาดกลางที่มีลักษณะการเลื่อนแบบ 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 ->
            // ...
        },
    )
}

วิดีโอต่อไปนี้แสดงผลลัพธ์ของข้อมูลโค้ดก่อนหน้า

รูปที่ 8 แถบแอปด้านบนขนาดกลางที่จัดแนวตรงกลางซึ่งจะยุบลงเมื่อผู้ใช้เลื่อนลง

ยืดหยุ่นขนาดใหญ่

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้แถบแอปด้านบนขนาดใหญ่ที่ยืดหยุ่นซึ่งมีลักษณะการเลื่อนแบบออกจนกว่าจะยุบ

@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 ->
            // ...
        },
    )
}

วิดีโอต่อไปนี้แสดงผลลัพธ์ของข้อมูลโค้ดก่อนหน้า

รูปที่ 9 แถบแอปด้านบนขนาดใหญ่ที่จัดแนวตรงกลางซึ่งจะยุบลงเมื่อผู้ใช้เลื่อนลง

แถบแอปด้านล่าง

หากต้องการสร้างแถบแอปด้านล่าง ให้ใช้ 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."
        )
    }
}

การใช้งานนี้จะปรากฏดังนี้

รูปที่ 10 ตัวอย่างการติดตั้งใช้งานแถบแอปด้านล่าง

การอัปเดต 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,
                )
            }
        }
    }
}

แหล่งข้อมูลเพิ่มเติม