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 dành 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 nhấn mạnh tầm quan trọng của nút.

Sắc độ được tô màu nền

Màu nền thay đổi để phù hợp với bề mặt.

Ngoài ra, bạn cũng có thể sử dụng tính năng này cho các hành động chính hoặc quan trọng. Các nút được tô màu nền giúp tăng trọng lượng hình ảnh và chức năng phù hợp, chẳng hạn 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 hoạt động hiệu quả với các nút khác để cho biết các hành động phụ, thay thế 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.

Các nút có mức độ nhấn mạnh thấp, phù hợp cho các thao tác ít quan trọng hơn như các đường liên kết điều hướng hoặ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.

Ví dụ về từng thành phần nút trong số 5 thành phần, trong đó nêu bật các đặc điểm riêng biệt của từng thành phần.
Hình 1. 5 thành phần nút.

Nền tảng API

  • onClick: Hàm được gọi khi người dùng nhấn 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ủa ButtonColors xác định màu sắc được sử 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, hình 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 này:

@Composable
fun FilledButtonExample(onClick: () -> Unit) {
    Button(onClick = { onClick() }) {
        Text("Filled")
    }
}

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

Một nút được tô màu nền màu tím có nội dung "filled" (đã tô màu).
Hình 2. Nút được tô màu nền.

Nút có sắc độ được tô màu nền

Thành phần nút sắc độ 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:

Một nút có màu sắc với nền màu tím nhạt có nội dung "đã điền".
Hình 3. Nút sắc độ.

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, thành phần hiển thị 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:

Một nút có đường viền trong suốt với đường viền màu tối có nội dung "Outlined" (Đường viền).
Hình 4. Một nút có đường viền.

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. Có theo mặc định, 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:

Một nút nâng cao có nền màu xám có nội dung "Nâng cao".
Hình 5. Một nút nâng cao.

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 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:

@Composable
fun TextButtonExample(onClick: () -> Unit) {
    TextButton(
        onClick = { onClick() }
    ) {
        Text("Text Button")
    }
}

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

Nút văn bản có nội dung "Text Button" (Nút văn bản)
Hình 6. Nút văn bản.

Tài nguyên khác