This component represents an html <select /> box. Use this component instead of the standard html one to leverage the layout and validation features of the fm:Form component.
As an added bonus the fm:Select box has a value attribute, which will be used to automatically set the correct selected="selected" attribute for the option component.
<fm:Form_Select name="agerange" value="31-40">
<fm:Form_Option value="11-20" label="11 - 20 years old">
<fm:Form_Option value="21-30" label="21 - 30 years old">
<fm:Form_Option value="31-40" label="31 - 40 years old">
</fm:Form_Select>
| Name | Required | Default | Description |
|---|---|---|---|
| class | Optional | The css classname that will be assigned to the actual html form field. Note that a few default classes might be added | |
| disabled | Optional | N/A | This will set the html disabled attribute |
| id | Optional | randomized | The id of the form element. Note that this id will also be used for the 'for' attribute in the <label> component |
| label | Optional | N/A | This attribute will be used to generate labels for this component, if it's used within an fm:Form component |
| language | Optional | N/A | This specifies which language to use for the display of the form_country dropdown. Choices are:
|
| multiple | Optional | N/A | Setting multiple will allow the user to select multiple items in this dropdown. |
| name | Required | N/A | The name of the form field. This is how the value will be submitted back to the server |
| readonly | Optional | N/A | This sets the html readonly attribute and controls if the user can change the value |
| required | Optional | 0 | Set required to '1' if you'd like the form validator to check if this form element has a value before submitting |
| size | Optional | N/A | The size attribute will be directly passed through to this component and dictates how much items are showing by default. |
| style | Optional | The style attribute for the actual form component | |
| title | Optional | N/A | Sets the title attribute on the select element. |
| value | Optional | The current value of the form element |
Most of the attributes you see here are just passed through to the actual select element.