ss:ajax:delayedload ss:ajax:event ss:ajax:region ss:data:calendar ss:data:column ss:data:repeater ss:data:table ss:data:tree ss:forms:captcha ss:forms:checkbox ss:forms:codeeditor ss:forms:combobox ss:forms:datepicker ss:forms:daterange ss:forms:dialogbox ss:forms:editbox ss:forms:fileupload ss:forms:fileuploadimage ss:forms:form ss:forms:hidden ss:forms:money ss:forms:officeuseregion ss:forms:option ss:forms:password ss:forms:paymentmethod ss:forms:radiobutton ss:forms:row ss:forms:searchbox ss:forms:selectlist ss:forms:signature ss:forms:slider ss:forms:spinbox ss:forms:submitbutton ss:forms:submitimage ss:forms:submitlink ss:forms:textarea ss:forms:timepicker ss:layout:rotator ss:layout:stepper ss:layout:stepperpanel ss:layout:tablist ss:layout:tablistitem ss:logic:dependency ss:logic:parse ss:logic:if ss:logic:else ss:logic:include ss:logic:template ss:logic:variable ss:navigation:breadcrumbs ss:navigation:item ss:navigation:primary ss:navigation:secondary ss:personalisation:firstname ss:personalisation:fullname ss:personalisation:lastname ss:personalisation:other ss:regions:content ss:regions:contentadditional ss:regions:security ss:regions:togglable ss:standard:audio ss:standard:embed ss:standard:icon ss:standard:image ss:standard:label ss:standard:link ss:standard:script ss:standard:video ss:templates:column ss:templates:row ss:templates:section ss:templates:teammember ss:thirdparty:googlemap ss:thirdparty:googlemapmarker
.
.
.

<ss:forms:radiobutton />

Radio buttons allow the user to choose one value from a set of options. Radio buttons that share the same name, are considered part of the same group.

Attributes

allowUncheck
bool
Allows the radiobutton to be unchecked.
focusOnLoad
bool
If true, this control will attempt to focus itself after the page has loaded. Note that only one element may be focused on the page at a time. Default = false.
height
mixed
Sets the height of the element. The default units are pixels. include the percentage symbol % to user percentage values.
id
string
Most form items need a unique id so that they can submit data to the server. No two form items may have the same id. For situations where multiple form items submit to the same field, see the name attribute. Id's that begin with contact_ will automatically save Contact information to the Contact database as long as the user has entered enough identifying information (ideally Name and Email). Check the Contact Fields page for correct field names.
label
bool
Label text that appears to the right of the button.
name
string
Pick a name unique within the parent form. Radio buttons that share the same name are considered part of the same group.
valueChecked
string
The value to send with the form, when this particular radio button is checked. All radio buttons in the same group (sharing the same name), should have different values for valuechecked.
width
mixed
Sets the width of the element. The default units are pixels. include the percentage symbol % to user percentage values.

Examples

Single Basic Radio Button

The most basic of radio buttons.

XML Code:


Run Example

Multiple Radiobuttons of Same Name

Demonstrates multiple checkboxes mapped to the same name.

XML Code:


Run Example

Radio Buttons and Ajax

Demonstrates using radio buttons in combination with Ajax.

XML Code:


Run Example