| Tag Type | C++ code (built in to libHForm/scan_body.cc) | |
|---|---|---|
| Attributes | var=varName | Required. Sets the variable name that this radio button controls. |
| option=value | Required. The value to put in var whenever this particular radio button is selected. | |
| confirm[=string] | Optional. If present, and if the client supports javascript, presents the user with an additional "are you sure?" dialog before allowing the Radio selection to be changed. If you give it a string value, it will be used as the question displayed for the user. [Added in RPM/2.9] | |
| onChange=actionId | Optional. If present, causes the form to be submitted immediately if the radio button is clicked on. The form goes back to the server and the associated Action is executed. | |
| Contained Tags | Any text or hyper-linkable images. When clicked, these will also cause the radio button to become selected as if the widget itself had been clicked on (works only with JavaScript). You MUST include a {/Radio} tag, even if you want to put it immediately after the {Radio} tag. | |
| Related Tags | This tag must appear in the Body section. | |
| Comments |
Several radio tags should be created all controlling the same
"var=" variable. The client software should ensure that only one
of the options can be selected at a time. See also
this example HForm using Radio tags. Like any other HForm widgets, radio buttons can be scattered about the form, or aligned using a table. Also, you do not need to have any text included in the {Radio}{/Radio} section, but you must always remember to include the {/Radio} even if there is no text in it. Here is another example HForm which illustrates a use for this. | |