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

XUI-Radio.png

XUI-Checkbox.png

results matching ""

    No results matching ""