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 = "1 番目";
    };
    {
        title = "2 番目";
    };
    {
        title = "3 番目";
    };
    {
        title = "4 番目";  -- オプションに value が設定されていない場合、設定値には title が使用されます
    };
    {
        title = "5 番目";
        value = "Fifth";  -- オプションに value が設定されている場合、設定値には value が使用されます
    };
    "最後";  -- オプションは省略記法で記述できます
    };
};