Documentation Archive Developer
Search
PATH Documentation > WebObjects

Table of Contents

WORadioButtonList



Element Description

WORadioButtonList displays a list of radio buttons. The user may select one of the objects in the list, and this object is returned as selection.


Synopsis

WORadioButtonList { list=anObjectList; item=anIteratedObject; displayString=displayedValue; [value=aValue;] [index=aNumber;] [prefix=prefixString;] [suffix=suffixString;] [selection=selectedValue;] [name=fieldName;] [disabled=aBoolean;] [escapeHTML=aBoolean;]... };

Bindings



list
Array of objects that the WORadioButtonList will iterate through.
item
Current item in the list array. (This attribute's value is updated with each iteration.)
displayString
String to display beside the radio button for the current item.
value
Value for the INPUT tag of the current item (INPUT type="RadioButton" value="someValue">.
index
Index of the current iteration of the WORadioButtonList.
prefix
An arbitrary HTML string inserted before each value.
suffix
An arbitrary HTML string inserted after each value.
selection
An object that the user chose from the list.
name
Name that uniquely identifies this element within the form. You may specify a name or let WebObjects automatically assign one at runtime.
disabled
If disabled evaluates to true (or YES), this element appears in the page but is not active.
escapeHTML
If escapeHTML evaluates to true (or YES), the string rendered by displayString is converted so that characters which would be interpreted as HTML control characters become their escaped equivalent (this is the default). Thus, if a your displayString is "a <b>bold</b> idea", the string passed to the client browser would be "a <B>bold</B> idea", but it would display in the browser as "a <b>bold</b> idea". If escapeHTML evaluates to false (or NO), WebObjects simply passes your data to the client browser "as is." In this case, the above example would display in the client browser as "a bold idea". If you are certain that your strings have no characters in them which might be interpreted as HTML control characters, you get better performance if you set escapeHTML to false (or NO).

Table of Contents
You should provide the title of a radio button in displayString rather than in value. If there is no binding for displayString, the string assigned to value is used as the label of the button.