radioGroup - ラジオボタングループ

選択またはクリアできる複数のボタンを表示します。選択できるボタンはグループ内で 1 つのみです。

カテゴリ

コアコントロール

構文

<xp:radioGroup attributes>content</xp:radioGroup>

表 1. 埋め込みコントロール
コントロール	説明
selectItem	ユーザー選択用の 1 つの項目を示します。
selectItems	ユーザー選択用の 1 つ以上の項目を示します。

表 2. 必須プロパティ
プロパティ	説明
id	デフォルトは `radioGroup1`、`radioGroup2` などです。
text	ラベルを示します。
value	コントロールをデータ要素またはその他の値にバインドします。
legend	画面で読み取り可能なグループの説明を提供します。

表 3. すべてのプロパティ
カテゴリ	プロパティ
アクセシビリティ	accesskey、legend、role、tabindex、title
basics	attrs、binding、dir、disabled、id、immediate、lang、loaded、readonly、rendered、rendererType、required
data	converter、defaultValue、disableClientSideValidation、disableModifiedFlag、disableValidators、showReadonlyAsDisabled、validator、validators、value、valueChangeListener、valueChangeListeners
dojo	dojoAttributes、dojoType
イベント	onblur、onchange、onclick、ondblclick、onfocus、onkeydown、 onkeypress、onkeyup、onmousedown、onmousemove、onmouseout、onmouseover、onmouseup
format	border、layout
styling	disabledClass、disableTheme、enabledClass、style、styleClass、themeId

使用法

実行時に、1 つ以上のラジオボタンがページに表示されます。ユーザーは 1 つのボタンを選択できます。 1 つのボタンを選択すると、それまで選択されていた他のボタンはクリアされます。

アクセシビリティに対応するために、legend プロパティを指定する必要があります。

例

下のラジオボタングループコントロールには、選択用の 2 つの項目があります。

<xp:radioGroup id="radioGroup1" legend="Select fruit" value="#{document1.fruit}" layout="pageDirection">
	<xp:selectItem itemLabel="Apples" itemValue="apples"></xp:selectItem>
	<xp:selectItem itemLabel="Oranges" itemValue="oranges"></xp:selectItem>
</xp:radioGroup>

下のラジオボタングループコントロールでは、式を使用して選択用の 2 つの項目が提供されています。

<xp:radioGroup id="radioGroup1" legend="Select fruit" value="#{document1.fruit}"
	layout="pageDirection">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:return new Array("Apples|apples", "Oranges|oranges")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:radioGroup>

このチェックボックスグループは、ビュー列の値から項目の選択を取得します。

<xp:radioGroup id="radioGroup1" legend="Select fruit" value="#{document1.fruit}"
	layout="pageDirection">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:var list = @DbColumn("", "fruits", 1);
			return @Explode(list,",")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:radioGroup>