Nút chọn / Hộp kiểm
Hiển thị nút chọn hoặc hộp kiểm.
Nhấn một nút chọn sẽ chọn nút đó và bỏ chọn các nút khác trong cùng nhóm. Nhấn một hộp kiểm sẽ chuyển đổi trạng thái chọn của hộp đó.
| Khóa | Kiểu | Mô tả | Bắt buộc | Mặc định | Phiên bản tối thiểu | Lưu ý |
|---|---|---|---|---|---|---|
| options | array of dictionaries | Danh sách tùy chọn | * | – | – | – |
| numPerLine | integer | Số mục trên mỗi dòng | – | 2 trên iPhone, 4 trên iPad | 1.2-10 | Tối đa 12 |
| minCount | integer | Số mục được chọn tối thiểu | – | 0 | – | Chỉ Checkbox |
| maxCount | integer | Số mục được chọn tối đa | – | INT_MAX | – | Chỉ Checkbox |
Mỗi từ điển tùy chọn gồm:
| Khóa | Kiểu | Mô tả | Điều kiện |
|---|---|---|---|
| title | string | Tiêu đề tùy chọn | Có thể bản địa hóa |
| value | primitive | Giá trị được lưu; mặc định là title nếu bỏ qua | Không bắt buộc |
Thành phần này không hỗ trợ label/icon/height. Dùng Group để thêm tiêu đề hoặc mô tả.
| Kiểu trả về | Mô tả |
|---|---|
| array of primitive | Mảng giá trị của các tùy chọn đã chọn |
Chủ đề
| Khóa chủ đề | Kiểu | Mô tả |
|---|---|---|
| tagTextColor | Color | Màu chữ thẻ |
| tagSelectedTextColor | Color | Màu chữ thẻ được chọn |
| tagBackgroundColor | Color | Màu nền thẻ |
| tagSelectedBackgroundColor | Color | Màu nền thẻ được chọn |
| tagBorderColor | Color | Màu viền thẻ |
| tagSelectedBorderColor | Color | Màu viền thẻ được chọn |
Ví dụ
{
cell = "Group";
label = "Nhóm hộp kiểm";
footerText = "Nhấn để chọn; nhấn lại để bỏ chọn; tối đa 4 mục";
};
{
default = { "Đỏ"; "Xanh lá"; };
cell = "Checkbox";
key = "checkbox";
maxCount = 4;
numPerLine = 4;
options = {
{ title = "Đỏ"; };
{ title = "Xanh lá"; };
{ title = "Xanh dương"; };
{ title = "Vàng"; };
"Tím";
"Đen";
"Trắng";
"Nâu";
"Kaki";
"Xám";
};
};
{
cell = "Group";
label = "Nhóm nút chọn";
footerText = "Nhấn để chọn";
};
{
default = "Thứ năm";
cell = "Radio";
key = "radio";
options = {
{ title = "Thứ nhất"; };
{ title = "Thứ hai"; };
{ title = "Thứ ba"; };
{ title = "Thứ tư"; };
{ title = "Thứ năm"; value = "Thứ năm"; };
"Cuối cùng";
};
};

