Button
Nút là các thành phần cơ bản cho phép người dùng kích hoạt một thao tác đã xác định. Có 5 loại nút. Bảng sau đây mô tả giao diện của từng loại nút trong số 5 loại, cũng như vị trí bạn nên sử dụng các nút đó.
Loại |
Diện mạo |
Mục đích |
---|---|---|
Lấp đầy (filled) |
Nền đồng nhất với văn bản tương phản. |
Nút nhấn mạnh. Đây là các nút cho các thao tác chính trong ứng dụng, chẳng hạn như "gửi" và "lưu". Hiệu ứng đổ bóng làm nổi bật tầm quan trọng của nút. |
Sắc độ được tô màu nền |
Màu nền thay đổi cho phù hợp với vùng hiển thị. |
Ngoài ra, bạn cũng có thể sử dụng cho các hành động chính hoặc quan trọng. Nút được tô màu sẽ tạo thêm trọng lượng hình ảnh và phù hợp với các chức năng như "thêm vào giỏ hàng" và "Đăng nhập". |
Hơi cao |
Nổi bật nhờ có bóng. |
Có vai trò tương tự như các nút sắc độ. Tăng độ cao để nút xuất hiện nổi bật hơn. |
Đường viền (outlined) |
Có đường viền không tô màu. |
Các nút có mức độ nhấn mạnh trung bình, chứa các thao tác quan trọng nhưng không phải thao tác chính. Các nút này kết hợp tốt với các nút khác để biểu thị các thao tác thay thế, phụ như "Huỷ" hoặc "Quay lại". |
Văn bản |
Hiển thị văn bản không có nền hoặc đường viền. |
Nút có mức độ nhấn mạnh thấp, phù hợp với các thao tác ít quan trọng hơn như đường liên kết điều hướng hoặc các chức năng phụ như "Tìm hiểu thêm" hoặc "Xem chi tiết". |
Hình ảnh sau đây minh hoạ 5 loại nút trong Material Design.
Nền tảng API
onClick
: Hàm được gọi khi người dùng nhấn vào nút.enabled
: Khi có giá trị false, tham số này sẽ khiến nút không xuất hiện và không hoạt động.colors
: Một thực thể củaButtonColors
xác định màu được dùng trong nút.contentPadding
: Khoảng đệm trong nút.
Nút được tô màu nền
Thành phần nút được tô màu sử dụng thành phần kết hợp Button
cơ bản. Theo mặc định, lớp này được tô bằng một màu đồng nhất. Đoạn mã sau đây minh hoạ cách triển khai thành phần:
@Composable fun FilledButtonExample(onClick: () -> Unit) { Button(onClick = { onClick() }) { Text("Filled") } }
Phương thức triển khai có dạng như sau:
Nút có sắc độ được tô màu nền
Thành phần nút tông màu được tô màu sử dụng thành phần kết hợp FilledTonalButton
.
Theo mặc định, lớp này được tô bằng một sắc độ màu.
Đoạn mã sau đây minh hoạ cách triển khai thành phần:
@Composable fun FilledTonalButtonExample(onClick: () -> Unit) { FilledTonalButton(onClick = { onClick() }) { Text("Tonal") } }
Phương thức triển khai có dạng như sau:
Nút có đường viền
Thành phần nút có đường viền sử dụng thành phần kết hợp OutlinedButton
. Theo mặc định, phần này sẽ xuất hiện cùng với đường viền.
Đoạn mã sau đây minh hoạ cách triển khai thành phần:
@Composable fun OutlinedButtonExample(onClick: () -> Unit) { OutlinedButton(onClick = { onClick() }) { Text("Outlined") } }
Phương thức triển khai có dạng như sau:
Nút lồi
Thành phần nút nâng cao sử dụng thành phần kết hợp ElevatedButton
. Theo mặc định, lớp phủ này có một bóng thể hiện hiệu ứng độ cao. Lưu ý rằng về cơ bản, đó là một nút được viền có bóng.
Đoạn mã sau đây minh hoạ cách triển khai thành phần:
@Composable fun ElevatedButtonExample(onClick: () -> Unit) { ElevatedButton(onClick = { onClick() }) { Text("Elevated") } }
Phương thức triển khai có dạng như sau:
Nút văn bản
Thành phần nút văn bản sử dụng thành phần kết hợp TextButton
. Cho đến khi được nhấn, nút này sẽ chỉ xuất hiện dưới dạng văn bản. Theo mặc định, hình dạng này không có đường viền hoặc màu nền đồng nhất.
Đoạn mã sau đây minh hoạ cách triển khai thành phần này:
@Composable fun TextButtonExample(onClick: () -> Unit) { TextButton( onClick = { onClick() } ) { Text("Text Button") } }
Phương thức triển khai có dạng như sau: