Radio

A Radio widget is displayed as a circle with text beside it that indicates a fixed set of choices from which only one can be selected. All the radio buttons in a list share the same data, and the change in status of a Radio widget can be detected by the other widgets on the page.

Implementation base

The Radio widget is a Dojo-based widget:
  • com.ibm.btt.dijit.RadioButton

Properties

The following properties can be configured for the Radio widget.
Table 1. Properties that can be configured for the Radio widget
Property Description
id The id is the identifier for the widget.
dataName The dataName property is the name of the data element to which the widget is bound. This property is mandatory.
value The value property specifies the value of the group of radio buttons when a radio button is selected.
text Is the text that is displayed on the label for a user if a value has not been assigned for the dataName property. This is an optional property.
visibility The visibility property defines how a widget is displayed on a GUI. The following values can be specified for this property:
visible
The widget is displayed on a GUI and users are able to interact with the widget.
hidden
The widget is not displayed on a GUI, but it occupies space on the GUI.
gone
The widget is not displayed on a GUI, and it does not occupy space on the GUI.
disabled Disabled elements cannot have focus, do not receive or fire mouse events, cannot receive user input. If you select a value of true for the disabled property, the widget is displayed on a GUI but a user cannot interact with it. Data contained in a disabled widget is not processed when the form is submitted. The default value for the disabled property is false.
shortcut The shortcut property specifies a keyboard shortcut for the widget. If a user enters the keyboard shortcut on a client, the widget receives focus on the GUI of the client. You can specify either a single character as the value of the shortcut property, or you can specify Ctrl and a character as the value of the shortcut property.
readOnly The readOnly property can be set to keep a user from changing the value. The default value for the readOnly property is false.
hint The hint is a description of the widget that is displayed as a tooltip for a user. The hint property has multilingual support.
styleClass The styleClass property specifies the name of the CSS style ( also known as CSS style class) associated with the widget. This property is set by selecting a style from the CSS styles table in the Style tab of the Properties view. If you do not configure the styleClass property, the default style is used instead. For more detailed information, refer to Setting CSS style to widgets

Data mapping

When the Radio widget is being loaded with data from a context, the radio button is selected if the value of the data field matches the value property of the Radio widget.

When data is sent from the Radio widget to a context, the value of the value property is sent.

ECA editor support

The following events, properties, and functions can be configured for the Radio widget with the ECA editor.
Table 2. Events that can be added to the Radiowidget by using the ECA editor.
Event Description
onClick Is fired when the left mouse button is clicked.
onKeyDown Is fired when a keyboard key is pressed.
onKeyUp Is fired when a keyboard key is released.
onKeyPress Is fired when a keyboard key is pressed or held down.
onMouseDown Is fired when a mouse button is clicked.
onMouseUp Is fired when a mouse button is released
onMouseEnter Is fired when the mouse pointer moves over the widget.
onMouseLeave Is fired when the mouse pointer moves out of the widget.
onMouseMove Is fired when the mouse pointer moves over nodes that are contained in the widget.
onChange Is fired when the value of the widget changes.
Table 3. Properties that can be configured for the Radio widget by using the ECA editor
Property Description
isChecked The isChecked property indicates whether the widget has been selected. Possible values are true and false..
text Is the text that is displayed on the label for a user if a value has not been assigned for the dataName property. This is an optional property.
visibility This property defines how a widget is displayed on a GUI. The following values can be specified for this property:
visible
The widget is displayed on a GUI and users are able to interact with the widget.
hidden
The widget is not displayed on a GUI, but it occupies space on the GUI.
gone
The widget is not displayed on a GUI, and it does not occupy space on the GUI.
Note: This property can be used in the Condition and Actions part of ECA rule.
readOnly The readOnly property can be set to keep a user from changing the value. The default value for the readOnly property is false.
disabled Disabled elements cannot have focus, do not receive or fire mouse events, cannot receive user input. If you select a value of true for the disabled property, the widget is displayed on a GUI but a user cannot interact with it. Data contained in a disabled widget is not processed when the form is submitted. The default value for the disabled property is false.
Note: This property can be used in the Condition and Actions part of ECA rule.
hint The hint is a description of the widget that is displayed as a tooltip for a user. The hint property has multilingual support.
Note: This property can be used in the Actions part of ECA rule.
styleClass The styleClass property specifies the name of the CSS style ( also known as CSS style class) associated with the widget. This property is set by selecting a style from the CSS styles table in the Style tab of the Properties view. If you do not configure the styleClass property, the default style is used instead. For more detailed information, refer to Setting CSS style to widgets
Note: This property can be used in the Actions part of ECA rule.
Table 4. Functions that can be configured for the Radio widget by using the ECA editor.
Function Description
isFocusable Returns a value of true if a widget can be focused and a value of false if it cannot be focused.
Note: The function can be used in the Condition part of ECA rule.
focus Specifies that the widget should be focused.
Note: The function can be used in the Actions part of ECA rule.