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
    };
    "倒数第一";  -- 选项可以简写
    };
};