Back
timeSelect()
Builds and returns a string containing three select
form controls for hour, minute, and second based on the supplied objectName and property.
Name | 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. | |
association | string | No | The name of the association that the property is located on. Used for building nested forms that work with nested properties. If you are building a form with deep nesting, simply pass in a list to the nested object, and CFWheels will figure it out. | |
position | string | No | The position used when referencing a hasMany relationship in the association argument. Used for building nested forms that work with nested properties. If you are building a form with deep nestings, simply pass in a list of positions, and CFWheels will figure it out. | |
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. |
secondStep | numeric | No | 1 | Pass in 10 to only show seconds 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 | false | 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. Label text placement can be controlled using aroundLeft or aroundRight. |
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. | |
errorElement | string | No | span | HTML tag to wrap the form control with when the object contains errors. |
errorClass | string | No | field-with-errors | The class name of the HTML tag that wraps the form control when there are errors. |
combine | boolean | No | Set to false to not combine the select parts into a single DateTime object. | |
twelveHour | boolean | No | false | whether to display the hours in 24 or 12 hour format. 12 hour format has AM/PM drop downs |
encode | any | No | true |
When set to true , encodes tag content, attribute values, and URLs so that Cross Site Scripting (XSS) attacks can be prevented. Set to attributes to only encode attribute values and not tag content.
|
<!---View code ---> #timeSelect(objectName="business", property="openUntil")# <!---Show fields for hour and minute ---> #timeSelect(objectName="business", property="openUntil", order="hour,minute")# <!---Only show 15-minute intervals ---> #timeSelect(objectName="appointment", property="dateTimeStart", minuteStep=15)#
Copied!