Radio / Checkbox 單選框 / 復選框組

此元件在介面上顯示若干單選框 / 復選框。

點選單選框會選中目前選擇的單選框，取消同組其它單選框的選中狀態。 點選復選框會切換其選中 / 未選狀態。

鍵	類型	描述	必選	預設值	最低版本需求	備注
options	包含字典的陣列	選項清單陣列	*	-	-	-
numPerLine	整數	每行選項個數	-	iPhone 為 2, iPad 為 4	1.2-10	最大值為 12
minCount	整數	最少選擇項目數	-	0	-	cell = 'Checkbox'
maxCount	整數	最多選擇項目數	-	INT_MAX	-	cell = 'Checkbox'

options 包含若干 選項, 選項 為字典，有如下屬性:

鍵	類型	描述	條件
title	字串	選項標題	可本地化
value	基本類型	選項設定值 若不填，則與 title 一致。	可選

此元件不支援 label/icon/height，如需要設定標題或備注，請結合 Group 元件進行設計。

返回類型	描述
包含基本類型的陣列	包含所有選中項 value 的陣列

主題

主題鍵	類型	描述
tagTextColor	顏色	標籤文字顏色
tagSelectedTextColor	顏色	選中標籤文字顏色
tagBackgroundColor	顏色	標籤背景顏色
tagSelectedBackgroundColor	顏色	選中標籤背景顏色
tagBorderColor	顏色	標籤邊框顏色
tagSelectedBorderColor	顏色	選中標籤邊框顏色

範例

{
    cell = "Group";
    label = "多选框组";
    footerText = "轻按以选中标签，再次轻按以取消选中，最多选择 4 项";
};
{
    default = {
        "红色";
        "绿色";
    };
    cell = "Checkbox";
    key = "checkbox";
    maxCount = 4;
    numPerLine = 4;  -- 每行選項數量
    options = {
        {
            title = "红色";
        };
        {
            title = "绿色";
        };
        {
            title = "蓝色";
        };
        {
            title = "黄色";
        };
        "紫色";
        "黑色";
        "白色";
        "咖啡色";
        "卡其色";
        "灰色";
    };
};
{
    cell = "Group";
    label = "单选框组";
    footerText = "轻按以选中标签";
};
{
    default = "Fifth";
    cell = "Radio";
    key = "radio";
    options = {
    {
        title = "第一";
    };
    {
        title = "第二";
    };
    {
        title = "第三";
    };
    {
        title = "第四";  -- 如果選項未設置 value，則該選項配置值為 title
    };
    {
        title = "第五";
        value = "Fifth";  -- 如果選項設置了 value，則該選項配置值為 value
    };
    "倒数第一";  -- 選項可以簡寫
    };
};