| Description: | Creates a select list form field for states in countries with the possibility to pre-select a state by full name or the state code. The database query is established as object of the calling CF document and only executed if it doesn't exist yet. |
| Syntax: |
<cf_selectstate
datasource = "data_source_name"
namestate = "form_field_name"
countries = "list of text strings"
selectstate = "state"
selecttype = "code" or "name">
|
| See also: | cf_selectcountry |
| Attributes: |
| Attribute Name | Required/Optional | Default | Description |
| datasource | required | oracle9 | The datasource to be queried for the list of states. |
| namestate | optional | s_code | Form field name for the state select list. |
| countries | required | USA | List of country codes separated by "|" (without quotes). A country must exactly match the country code in the database. |
| selectstate | optional |
| Pre-selected state value. |
| selecttype | optional | code | Determines if the custom tag uses/returns the full country names name or the state abbreviation code. |
|
| Returns: | The HTML code for the form field. |
| Example: |
<cf_selectstate countries="USA" selectstate="MA">
|
