You are viewing documentation for v1.0.x. Change

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>