monthSelectTag()
Description
Builds and returns a string containing a select form control for the months of the year based on the supplied name.
Function Syntax
monthSelectTag(name [, selected, monthDisplay, includeBlank, label, labelPlacement, prepend, append, prependToLabel, appendToLabel ])
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name |
string |
Yes | |
Name to populate in tag's name attribute. |
selected |
string |
No | |
The month that should be selected initially. |
monthDisplay |
string |
No | names |
Pass in names, numbers, or abbreviations to control display. |
includeBlank |
any |
No | false |
Whether to include a blank option in the select form control. Pass true to include a blank line or a string that should represent what display text should appear for the empty value (for example, "- Select One -"). |
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 with HTML tags. |
append |
string |
No | |
String to append to the form control. Useful to wrap the form control with HTML tags. |
prependToLabel |
string |
No | |
String to prepend to the form control's label. Useful to wrap the form control with HTML tags. |
appendToLabel |
string |
No | |
String to append to the form control's label. Useful to wrap the form control with HTML tags. |
Examples
<!--- This "Tag" version of the function accepts a `name` and `selected` instead of binding to a model object --->
<cfoutput>
#monthSelectTag(name="monthOfBirthday", selected=params.monthOfBirthday)#
</cfoutput>
