View Helpers Form Tag Functions string controller
Builds and returns a string containing one select
form control for the minutes of an hour based on the supplied name.
Name | Type | Required | Default | Description |
---|---|---|---|---|
name | string | Yes | Name to populate in tag's name attribute. | |
selected | string | No | The day that should be selected initially. | |
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. 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. | |
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. |
// This "Tag" version of the function accepts a `name` and `selected` instead of binding to a model object <cfoutput> #minuteSelectTag(name="minuteOfMeeting", value=params.minuteOfMeeting)# </cfoutput> // Only show 15-minute intervals <cfoutput> #minuteSelectTag(name="minuteOfMeeting", value=params.minuteOfMeeting, minuteStep=15)# </cfoutput>