Scaffold

Trong Material Design, một giàn giáo là một cấu trúc cơ bản cung cấp một nền tảng chuẩn hoá cho các giao diện người dùng phức tạp. Cấu phần này kết hợp nhiều phần khác nhau của giao diện người dùng, chẳng hạn như thanh ứng dụng và nút hành động nổi, mang đến cho ứng dụng giao diện nhất quán.

Ví dụ

Thành phần kết hợp Scaffold cung cấp một API đơn giản mà bạn có thể sử dụng để nhanh chóng tập hợp cấu trúc của ứng dụng theo nguyên tắc Material Design. Scaffold chấp nhận một số thành phần kết hợp làm tham số. Trong số đó có:

  • topBar: Thanh ứng dụng ở đầu màn hình.
  • bottomBar: Thanh ứng dụng ở cuối màn hình.
  • floatingActionButton: Một nút di chuột qua góc dưới cùng bên phải của màn hình mà bạn có thể sử dụng để hiển thị các thao tác chính.

Để biết thêm ví dụ chi tiết về cách triển khai cả thanh ứng dụng trên cùng và dưới cùng, hãy xem trang thanh ứng dụng.

Bạn cũng có thể truyền nội dung Scaffold như cách bạn truyền nội dung đến các vùng chứa khác. Hàm này truyền giá trị innerPadding đến hàm lambda content mà bạn có thể sử dụng trong các thành phần kết hợp con.

Ví dụ sau đây cung cấp ví dụ đầy đủ về cách bạn có thể triển khai Scaffold. Thành phần này chứa thanh ứng dụng trên cùng, thanh ứng dụng dưới cùng và nút hành động nổi tương tác với trạng thái nội bộ của Scaffold.

@Composable
fun ScaffoldExample() {
    var presses by remember { mutableIntStateOf(0) }

    Scaffold(
        topBar = {
            TopAppBar(
                colors = topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text("Top app bar")
                }
            )
        },
        bottomBar = {
            BottomAppBar(
                containerColor = MaterialTheme.colorScheme.primaryContainer,
                contentColor = MaterialTheme.colorScheme.primary,
            ) {
                Text(
                    modifier = Modifier
                        .fillMaxWidth(),
                    textAlign = TextAlign.Center,
                    text = "Bottom app bar",
                )
            }
        },
        floatingActionButton = {
            FloatingActionButton(onClick = { presses++ }) {
                Icon(Icons.Default.Add, contentDescription = "Add")
            }
        }
    ) { innerPadding ->
        Column(
            modifier = Modifier
                .padding(innerPadding),
            verticalArrangement = Arrangement.spacedBy(16.dp),
        ) {
            Text(
                modifier = Modifier.padding(8.dp),
                text =
                """
                    This is an example of a scaffold. It uses the Scaffold composable's parameters to create a screen with a simple top app bar, bottom app bar, and floating action button.

                    It also contains some basic inner content, such as this text.

                    You have pressed the floating action button $presses times.
                """.trimIndent(),
            )
        }
    }
}

Phương thức triển khai có dạng như sau:

Cách triển khai một khung chứa các thanh ứng dụng trên cùng và dưới cùng đơn giản, cũng như một nút hành động nổi lặp lại một bộ đếm. Nội dung bên trong của khung là văn bản đơn giản giải thích về thành phần.
Hình 1. Cách triển khai scaffolding.

Tài nguyên khác