Table of Contents Previous Section

WORadioButton

WORadioButton {[value=defaultValue; [selection=selectedValue]]; [name=fieldName;] [disabled=YES|NO;] ... };

WORadioButton {[checked=YES|NO;] [name=fieldName;] [disabled=YES|NO;] ... };

Description

WORadioButton represents itself as an on-off switch. Radio buttons are normally grouped, since the most important aspect of their behavior is that they allow the user to select no more than one of several choices. If the user selects one button, the previously selected button (if any) becomes deselected.

Since radio buttons normally appear as a group, WORadioButton is commonly found within a WORepetition.

checked

During page generation, if checked evaluates to YES, the radio button appears in the selected state. During request handling, checked reflects the state the user left the radio button in: YES if checked; NO if not.

value

Value of this input element. If not specified, WebObjects provides a default value.

selection

If selection and value are equal when the page is generated, the radio button is selected. When the page is submitted, selection is assigned the value of the radio button.

name

Name that identifies the radio button's group. Only one radio button at a time can be selected within a group.

disabled

If disabled evaluates to YES, this element appears in the page but is not active.

Note that either checked or value is required in a WORadioButton declaration, but that they are mutually exclusive.

Examples

Table of Contents Next Section