4.3.1 Grouping Functions

RadioButtonGroup is an additional functional widget to create the mutually exclusive RadioButtons group.

Grouping radio buttons, RadioButtons belonging to the RadioButtonGroup behave as well as the radio button group used in HTML.

There is a single focus for the whole group
You can change the selection status of radio buttons in the group using the cursor keys

Format

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

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

Note

You cannot specify child elements. Refer to 4.4.1.4 Behavior when child elements are specified for widgets that cannot contain child elements for details.
There is no difference if it is specified in the <div> tag or the <span> tag because this widget is not displayed on-screen.

Properties

The meaning of the column headers is explained in Properties topic of the section 4.2.1.1 Text.

Name	Data Type	Description	Required	Default Value
targets	Array	Specifies the list of RadioButton IDs included in the group. Note that the order of items in the targets property is the order in which the focus shifts. An error occurs if the value of this property is one of the following: If no widget with the specified ID exists If the widget with the specified ID is not a RadioButton If the value of the value property for the specified RadioButton is an empty string If multiple RadioButtons with the same value exist in the group	Yes	-
selectedValue	String	Specifies the selected RadioButton value. If you specify an empty string, the last RadioButton in the order specified in the targets property whose checked property is true is selected. If a value that does not match any value in the group is specified, an error occurs.	No	""

Name

Data Type

Description

Required

Default Value

targets

Array

Specifies the list of RadioButton IDs included in the group.

Note that the order of items in the targets property is the order in which the focus shifts.

An error occurs if the value of this property is one of the following:

If no widget with the specified ID exists
If the widget with the specified ID is not a RadioButton
If the value of the value property for the specified RadioButton is an empty string
If multiple RadioButtons with the same value exist in the group

Yes

selectedValue

String

Specifies the selected RadioButton value. If you specify an empty string, the last RadioButton in the order specified in the targets property whose checked property is true is selected.

If a value that does not match any value in the group is specified, an error occurs.

Note

For creating a RadioButtonGroup, value property for each radio button of the RadioButtonGroup needs to be provided. As Web Console does not use this value for updating UDA, you can provide any value to radio button value property.

You can also specify common properties for screen widgets and additional functional widgets. For more details, refer to 4.2.4 Common Properties for Screen Widgets and 4.3.2 Common Properties for Additional Functional Widgets

Creating a radio button group

To create a radio button group, specify the IDs of the RadioButton widgets to include in the group in the targets property.

An example is as follows:

...
<span rcf:id="radioButton1" rcf:type="IBPMRadioButton" rcf:value="val1" rcf:label="Radio Button 1"></span>
<span rcf:id="radioButton2" rcf:type="IBPMRadioButton" rcf:value="val2" rcf:label="Radio Button 2"></span>
 ...
<span rcf:id="group1" rcf:type="RadioButtonGroup" rcf:targets="radioButton1; radioButton2" ... ></span>
 ...

4.3.1 Grouping Functions

4.3.1.1 RadioButtonGroup