radio - ラジオボタン

選択またはクリアできるボタンを表示します。グループ化されている場合、選択できるボタンはグループ内で 1 つのみです。

カテゴリ

コアコントロール

構文

<xp:radio attributes>content</xp:radio>

表 1. 必須プロパティ
プロパティ	説明
id	デフォルトは `radio1`、`radio2` などです。
text	ラベルを示します。
value	コントロールをデータ要素またはその他の値にバインドします。
selectedValue	ボタンが選択されたときのデータ値を指定します。
defaultSelected	デフォルトでボタンが選択された状態にする場合は、`true` を指定します。
groupName	ラジオボタンをグループに割り当てます。
skipContainers	複数の異なるコンテナ (データ表の列など) のラジオボタンを同じグループに割り当てます。

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

使用法

実行時に、ボタンがページに表示されます。ユーザーは、このチェックボックスを選択、またはクリアできます。選択すると、ボタンの中が塗りつぶされます。

ボタンを選択すると、同じグループに割り当てられた他のボタンはすべてクリアされます。

グループへのボタンの割り当ては、ラジオボタングループコントロールの作成と同様に行います。個々のボタンをグループに割り当てて使用することで、配置を柔軟に行うことができます。

アクセシビリティに準拠するためには、このコントロールをグループに対して使用せず、単一のボタンに対してのみ使用します。グループに対しては、ラジオボタングループを使用してください。

例

以下のラジオボタンコントロールは、値 apples または oranges のうち選択された方を、document1.fruit に割り当てます。ボタンはお互いに呼応して動作します。 Apples が選択された場合、 oranges はクリアされます。この例はアクセシビリティ準拠に適合していないことに注意してください。

<xp:radio text="Apples" id="radio1" value="#{document1.fruit}"
	groupName="fruit" selectedValue="apples">
</xp:radio>
<xp:radio text="Oranges" id="radio2" value="#{document1.fruit}"
	groupName="fruit" selectedValue="oranges">
</xp:radio>