Khối (chip)

Thành phần Chip là một phần tử trên giao diện người dùng nhỏ gọn, có tính tương tác. Thành phần này đại diện cho các thực thể phức tạp như người liên hệ hoặc thẻ, thường có biểu tượng và nhãn. Thành phần này có thể kiểm tra, đóng hoặc nhấp được.

Sau đây là 4 loại khối và trường hợp bạn có thể sử dụng:

  • Hỗ trợ: Hướng dẫn người dùng trong một nhiệm vụ. Thường xuất hiện dưới dạng một thành phần giao diện người dùng tạm thời để phản hồi hoạt động đầu vào của người dùng.
  • Bộ lọc: Cho phép người dùng tinh chỉnh nội dung trong một nhóm lựa chọn. Người dùng có thể chọn hoặc bỏ chọn các mục này và có thể thấy biểu tượng dấu kiểm khi chọn.
  • Thông tin đầu vào: Đại diện cho thông tin do người dùng cung cấp, chẳng hạn như các lựa chọn trong trình đơn. Khối có thể chứa biểu tượng và văn bản, đồng thời cung cấp biểu tượng X để xoá.
  • Đề xuất: Đưa ra đề xuất cho người dùng dựa trên hoạt động hoặc thông tin đầu vào gần đây của họ. Thường xuất hiện bên dưới trường nhập dữ liệu để nhắc người dùng thực hiện hành động.
Ví dụ về từng thành phần trong số 4 thành phần khối, trong đó có nêu bật các đặc điểm riêng biệt của từng thành phần.
Hình 1. Bốn thành phần khối.

Nền tảng API

Có 4 thành phần kết hợp tương ứng với 4 loại khối. Các phần sau đây trình bày chi tiết về các thành phần kết hợp này và sự khác biệt giữa chúng. Tuy nhiên, các phương thức này có chung các tham số sau:

  • label: Chuỗi xuất hiện trên khối.
  • icon: Biểu tượng hiển thị ở đầu khối. Một số thành phần kết hợp cụ thể có tham số leadingIcon và trailingIcon riêng biệt.
  • onClick: Hàm lambda mà khối gọi khi người dùng nhấn vào khối đó.

Khối hỗ trợ

Thành phần kết hợp AssistChip cung cấp một cách đơn giản để tạo khối hỗ trợ nhằm hướng người dùng theo một hướng cụ thể. Một tính năng nổi bật là tham số leadingIcon cho phép bạn hiển thị biểu tượng ở bên trái của khối. Ví dụ sau đây minh hoạ cách bạn có thể triển khai:

@Composable
fun AssistChipExample() {
    AssistChip(
        onClick = { Log.d("Assist chip", "hello world") },
        label = { Text("Assist chip") },
        leadingIcon = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Settings),
                contentDescription = "Localized description",
                Modifier.size(AssistChipDefaults.IconSize)
            )
        }
    )
}

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

Hình 2. Khối hỗ trợ.

Thẻ bộ lọc

Thành phần kết hợp FilterChip yêu cầu bạn theo dõi xem khối có được chọn hay không. Ví dụ sau đây minh hoạ cách bạn có thể chỉ hiện biểu tượng đã đánh dấu ở đầu khi người dùng đã chọn khối:

@Composable
fun FilterChipExample() {
    var selected by remember { mutableStateOf(false) }

    FilterChip(
        onClick = { selected = !selected },
        label = {
            Text("Filter chip")
        },
        selected = selected,
        leadingIcon = if (selected) {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Done),
                    contentDescription = "Done icon",
                    modifier = Modifier.size(FilterChipDefaults.IconSize)
                )
            }
        } else {
            null
        },
    )
}

Phương thức triển khai có dạng như sau khi được chọn:

Hình 3. Khối bộ lọc đã chọn.

Khối nhập dữ liệu

Bạn có thể sử dụng composable InputChip để tạo các khối xuất phát từ hoạt động tương tác của người dùng. Ví dụ: trong ứng dụng email, khi người dùng đang viết email, khối nhập có thể đại diện cho một người liên hệ mà người dùng đã thêm vào trường "Tới:".

Cách triển khai sau đây minh hoạ một khối thông tin đầu vào đã ở trạng thái được chọn. Người dùng đóng khối khi nhấn vào khối đó.

@Composable
fun InputChipExample(
    text: String,
    onDismiss: () -> Unit,
) {
    var enabled by remember { mutableStateOf(true) }
    if (!enabled) return

    InputChip(
        onClick = {
            onDismiss()
            enabled = !enabled
        },
        label = { Text(text) },
        selected = enabled,
        avatar = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Person),
                contentDescription = "Localized description",
                Modifier.size(InputChipDefaults.AvatarSize)
            )
        },
        trailingIcon = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Close),
                contentDescription = "Localized description",
                Modifier.size(InputChipDefaults.AvatarSize)
            )
        },
    )
}

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

Hình 4. Khối nhập liệu.

Khối đề xuất

Thành phần kết hợp SuggestionChip là thành phần kết hợp cơ bản nhất trong số các composable được liệt kê trên trang này, cả về định nghĩa API và các trường hợp sử dụng phổ biến. Khối đề xuất trình bày các gợi ý được tạo linh động. Ví dụ: trong một ứng dụng Trò chuyện với AI, bạn có thể sử dụng khối đề xuất để đưa ra các câu trả lời có thể có cho tin nhắn gần đây nhất.

Hãy xem xét cách triển khai SuggestionChip sau đây:

@Composable
fun SuggestionChipExample() {
    SuggestionChip(
        onClick = { Log.d("Suggestion chip", "hello world") },
        label = { Text("Suggestion chip") }
    )
}

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

Hình 5. Khối đề xuất.

Khối nổi bật

Tất cả ví dụ trong tài liệu này đều sử dụng các thành phần kết hợp cơ sở có giao diện phẳng. Nếu bạn muốn có một khối có giao diện nâng cao, hãy sử dụng một trong ba thành phần kết hợp sau:

Bản cập nhật M3 Expressive

Thẻ bộ lọc và thẻ nhập liệu có các bản cập nhật về kiểu dáng, bao gồm cả việc tăng bán kính góc và chuyển động lò xo. Khối hỗ trợ và khối đề xuất đã được hợp nhất thành các nút biểu cảm.

Để biết thêm thông tin về các bản cập nhật M3 Expressive cho khối, hãy xem Nguyên tắc về khối trong Material Design 3.

Biến đổi góc

Khối bộ lọc và khối nhập hỗ trợ biến đổi góc, tạo ảnh động cho bán kính góc của vùng chứa từ 12 dp khi không được chọn thành bo tròn hoàn toàn khi được chọn.

Bộ lọc

Đoạn mã sau đây minh hoạ cách triển khai khối bộ lọc có hiệu ứng biến đổi góc:

@Composable
fun FilterChipWithCornerMorphingSample() {
    var selected by remember { mutableStateOf(false) }
    FilterChip(
        selected = selected,
        onClick = { selected = !selected },
        label = { Text("Filter chip") },
        shapes = FilterChipDefaults.shapes(),
        leadingIcon = if (selected) {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Done),
                    contentDescription = null,
                    modifier = Modifier.size(FilterChipDefaults.IconSize),
                )
            }
        } else {
            null
        },
    )
}

Bộ lọc nâng cao

Khối bộ lọc nâng cao giúp phân tách khỏi nền nổi bật về mặt hình ảnh và hỗ trợ biến đổi góc. Đoạn mã sau đây minh hoạ cách triển khai khối bộ lọc nâng cao có hiệu ứng biến đổi góc:

@Composable
fun ElevatedFilterChipWithCornerMorphingSample() {
    var selected by remember { mutableStateOf(false) }
    ElevatedFilterChip(
        selected = selected,
        onClick = { selected = !selected },
        label = { Text("Filter chip") },
        shapes = FilterChipDefaults.shapes(),
        leadingIcon = if (selected) {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Done),
                    contentDescription = null,
                    modifier = Modifier.size(FilterChipDefaults.IconSize),
                )
            }
        } else {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Home),
                    contentDescription = null,
                    modifier = Modifier.size(FilterChipDefaults.IconSize),
                )
            }
        },
        trailingIcon = {
            Icon(
                painter = rememberVectorPainter(AppIcons.ArrowDropDown),
                contentDescription = null,
                modifier = Modifier.size(FilterChipDefaults.IconSize),
            )
        },
    )
}

Đầu vào

Khối thông tin đầu vào đại diện cho các phần thông tin riêng biệt do người dùng nhập và cũng hỗ trợ biến đổi góc. Đoạn mã sau đây minh hoạ cách triển khai khối thông tin đầu vào có hiệu ứng biến đổi góc:

@Composable
fun InputChipWithCornerMorphingSample() {
    var selected by remember { mutableStateOf(false) }
    InputChip(
        selected = selected,
        onClick = { selected = !selected },
        label = { Text("Input Chip") },
        shapes = InputChipDefaults.shapes(),
        avatar = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Person),
                contentDescription = null,
                modifier = Modifier.size(InputChipDefaults.AvatarSize),
            )
        },
    )
}

Khối hỗ trợ và đề xuất

Khối hỗ trợ và khối đề xuất được hợp nhất thành các nút biểu cảm trong Material 3 Biểu cảm vì chúng phản ánh chức năng của các hành vi nút hành động đơn lẻ. Sử dụng các nút biểu cảm khi bạn cần hành vi của khối đề xuất hoặc khối hỗ trợ biểu cảm; hãy xem Tài liệu về nút để biết thông tin chi tiết về cách triển khai.

Tài nguyên khác