radioButtonTag()
Description
Builds and returns a string containing a radio button form control based on the supplied name.
Function Syntax
radioButtonTag(name, value [, checked, label, labelPlacement, prepend, append, prependToLabel, appendToLabel ])
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name |
string |
Yes | |
Name to populate in tag's name attribute. |
value |
string |
Yes | |
Value to populate in tag's value attribute. |
checked |
boolean |
No | false |
Whether or not to check the radio button by default. |
label |
string |
No | |
The label text to use in the form control. |
labelPlacement |
string |
No | around |
Whether to place the label before, after, or wrapped around the form control. |
prepend |
string |
No | |
String to prepend to the form control. Useful to wrap the form control around HTML tags. |
append |
string |
No | |
String to append to the form control. Useful to wrap the form control around HTML tags. |
prependToLabel |
string |
No | |
String to prepend to the form control's label. Useful to wrap the form control around HTML tags. |
appendToLabel |
string |
No | |
String to append to the form control's label. Useful to wrap the form control around HTML tags. |
Examples
<!--- view code --->
<cfoutput>
<p>
#radioButtonTag(name="gender", value="m", label="Male", checked=true)#<br />
#radioButtonTag(name="gender", value="f", label="Female")#
</p>
</cfoutput>
