4.3.1 グループ化機能付加部品

RadioButtonGroupは、複数のRadioButtonからなる相互排他的なグループを形成する機能付加部品です。

ラジオボタングループを形成することにより、RadioButtonGroupに属するRadioButtonは、HTMLの同名のラジオボタン群と同様の動きをします。

グループのRadioButton群で1つのフォーカスを構成
グループ内の選択状態を、カーソルキーで変更可能

記述形式

<div rcf:type="RadioButtonGroup" rcf:targets="xxx1; xxx2; ... "></div>

または

<span rcf:type="RadioButtonGroup" rcf:targets="xxx1; xxx2; ... "></span>

注意

子要素は記述できません。詳細は、“4.4.1.4 子要素を持たない部品に子要素を記述した場合の動作”を参照してください。
本部品は画面に表示されないため、<div>タグおよび<span>タグのどちらで記述しても違いはありません。

プロパティ

表の項目の意味は、“Text”の“プロパティ”を参照してください。

名前	データ型	説明	省略	省略値
targets	Array	グループを形成するRadioButtonのidのリストです。グループ内のカーソルキーによるフォーカスの制御は、本プロパティの指定順に従います。本プロパティが以下の値の場合は、エラーとなります。指定されたidを持つ部品が存在しない指定されたidを持つ部品がRadioButtonではない指定されたRadioButtonのvalueが空文字列であるグループ内に同じvalueを持つRadioButtonが存在する	不可	-
selectedValue	String	選択されているRadioButtonのvalueです。本プロパティが空文字列の場合、checkedプロパティがtrueのRadioButtonのなかで、targetsの指定順が最後のものを選択状態にします。グループ内のどのvalueとも一致しない値が指定された場合は、エラーとなります。	可	""

名前

データ型

説明

省略

省略値

targets

Array

グループを形成するRadioButtonのidのリストです。
グループ内のカーソルキーによるフォーカスの制御は、本プロパティの指定順に従います。
本プロパティが以下の値の場合は、エラーとなります。

指定されたidを持つ部品が存在しない
指定されたidを持つ部品がRadioButtonではない
指定されたRadioButtonのvalueが空文字列である
グループ内に同じvalueを持つRadioButtonが存在する

不可

selectedValue

String

選択されているRadioButtonのvalueです。
本プロパティが空文字列の場合、checkedプロパティがtrueのRadioButtonのなかで、targetsの指定順が最後のものを選択状態にします。
グループ内のどのvalueとも一致しない値が指定された場合は、エラーとなります。

可

注意

RadioButtonGroupを形成する各RadioButtonのvalueプロパティは、値を指定する必要があります。WebコンソールがUDAの更新にこの値を使用しないとき、valueプロパティにはどのような値でも指定できます

そのほかにも、画面部品および機能付加部品で共通のプロパティを指定することができます。詳細は、“4.2.4 画面部品共通プロパティ”、および“4.3.2 機能付加部品共通プロパティ”を参照してください。

ラジオボタングループの形成

ラジオボタングループを形成するには、targetsプロパティにグループに含めるRadioButtonのidのリストを指定します。

以下に例を示します。

...
<span rcf:id="radioButton1" rcf:type="IBPMRadioButton" rcf:value="val1" rcf:label="ラジオボタン1"></span>
<span rcf:id="radioButton2" rcf:type="IBPMRadioButton" rcf:value="val2" rcf:label="ラジオボタン2"></span>
 ...
<span rcf:id="group1" rcf:type="RadioButtonGroup" rcf:targets="radioButton1; radioButton2" ... ></span>
 ...

4.3.1 グループ化機能付加部品

4.3.1.1 RadioButtonGroup