メインコンテンツまでスキップ

Radio / Checkbox ラジオボタン / チェックボックスグループ

このコンポーネントは、画面上に複数のラジオボタンまたはチェックボックスを表示します。

ラジオボタンをタップすると、そのボタンが選択され、同じグループ内のほかのラジオボタンの選択が解除されます。 チェックボックスをタップすると、選択状態と未選択状態が切り替わります。

キー説明必須デフォルト値最低対応バージョン備考
options辞書の配列オプション一覧*---
numPerLine整数行ごとのオプション数-iPhone では 2、iPad では 41.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