Thành phần Switch
cho phép người dùng chuyển đổi giữa hai trạng thái: đã đánh dấu và chưa đánh dấu. Sử dụng nút chuyển để cho phép người dùng thực hiện một trong những thao tác sau:
- Bật hoặc tắt một chế độ cài đặt.
- Bật hoặc tắt một tính năng.
- Chọn một lựa chọn.
Thành phần này có hai phần: con trỏ và dải âm thanh. Thumb là phần có thể kéo của nút chuyển và track là nền. Người dùng có thể kéo nút gạt sang trái hoặc phải để thay đổi trạng thái của nút chuyển. Người dùng cũng có thể nhấn vào nút chuyển để kiểm tra và xoá.
Khả năng tương thích của phiên bản
Phương thức triển khai này yêu cầu bạn phải đặt minSDK của dự án thành API cấp 21 trở lên.
Phần phụ thuộc
Triển khai nút chuyển
Ví dụ sau đây là cách triển khai tối thiểu thành phần kết hợp Switch
:
Kết quả
![Một nút chuyển cơ bản chưa được đánh dấu.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-deactivated.png?hl=vi)
![Một Nút chuyển cơ bản đã được đánh dấu.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch.png?hl=vi)
Tạo hình thu nhỏ tuỳ chỉnh
Bạn có thể truyền bất kỳ thành phần kết hợp nào cho tham số thumbContent
để tạo một hình thu nhỏ tuỳ chỉnh. Sau đây là ví dụ về một nút chuyển sử dụng biểu tượng tuỳ chỉnh cho nút nhấn:
Kết quả
Giao diện chưa đánh dấu giống như ví dụ trong phần trước. Tuy nhiên, khi được đánh dấu, cách triển khai này sẽ xuất hiện như sau:
![Một nút chuyển sử dụng thông số thumbContent để hiển thị một biểu tượng tuỳ chỉnh khi được đánh dấu.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-icon.png?hl=vi)
Sử dụng màu tuỳ chỉnh
Sử dụng tham số colors
để thay đổi màu của nút và đường dẫn của nút chuyển, có tính đến việc nút chuyển có được đánh dấu hay không.
Kết quả
![Một nút chuyển sử dụng tham số màu để hiển thị nút chuyển có màu tuỳ chỉnh cho cả nút và ghim.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-colors.png?hl=vi)
Điểm chính
Tham số cơ bản:
checked
: Trạng thái ban đầu của nút chuyển.onCheckedChange
: Lệnh gọi lại được gọi khi trạng thái của nút chuyển thay đổi.enabled
: Liệu nút chuyển đang bật hay tắt.colors
: Màu sắc dùng cho nút chuyển.
Tham số nâng cao
thumbContent
: Sử dụng thuộc tính này để tuỳ chỉnh giao diện của ngón tay cái khi được đánh dấu.colors
: Sử dụng thuộc tính này để tuỳ chỉnh màu của bản nhạc và con trỏ.
Các bộ sưu tập chứa hướng dẫn này
Hướng dẫn này là một phần của các bộ sưu tập Hướng dẫn nhanh được tuyển chọn này, bao gồm các mục tiêu phát triển Android rộng hơn:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=vi)