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.
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ốleadingIconvàtrailingIconriê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.
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:
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.
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:
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.