timeSelect()
Description
Builds and returns a string containing three select form controls for a time based on the supplied objectName and property.
Function Syntax
timeSelect([ objectName, property, order, separator, minuteStep, includeBlank, label, labelPlacement, prepend, append, prependToLabel, appendToLabel, errorElement ])
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectName |
any |
No | |
The variable name of the object to build the form control for. |
property |
string |
No | |
The name of the property to use in the form control. |
order |
string |
No | hour,minute,second |
Use to change the order of or exclude time select tags. |
separator |
string |
No | : |
Use to change the character that is displayed between the time select tags. |
minuteStep |
numeric |
No | 1 |
Pass in 10 to only show minute 10, 20,30 etc. |
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 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. |
errorElement |
string |
No | span |
HTML tag to wrap the form control with when the object contains errors. |
Examples
<!--- view code --->
<cfoutput>
<p>#timeSelect(objectName="business", property="openUntil")#</p>
</cfoutput>
