Builds and returns a string containing three select form controls for month, day, and year 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 | Yes | 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 Wheels 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 Wheels will figure it out. | |
order | string | No | month,day,year | Use to change the order of or exclude date select tags. |
seperator | string | No | Use to change the character that is displayed between the date select tags. | |
startYear | numeric | No | 2009 | First year in select list. |
endYear | numeric | No | 2019 | Last year in select list. |
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 | 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 | fieldWithErrors | The class name of the HTML tag that wraps the form control when there are errors. |
combine | boolean | No |
dateSelect([ objectName, property, association, position, order, separator, startYear, endYear, monthDisplay, includeBlank, label, labelPlacement, prepend, append, prependToLabel, appendToLabel, errorElement, errorClass, combine ]) <!--- View code ---> <cfoutput> #dateSelect(objectName="user", property="dateOfBirth")# </cfoutput> <!--- Show fields to select month and year ---> <cfoutput> #dateSelect(objectName="order", property="expirationDate", order="month,year")# </cfoutput>