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>

Supported attributes

classOptionalThe css classname that will be assigned to the actual html form field. Note that a few default classes might be added
disabledOptionalN/AThis will set the html disabled attribute
idOptionalrandomizedThe id of the form element. Note that this id will also be used for the 'for' attribute in the <label> component
labelOptionalN/AThis attribute will be used to generate labels for this component, if it's used within an fm:Form component
languageOptionalN/AThis specifies which language to use for the display of the form_country dropdown. Choices are:
  • en - English
  • es - Spanish
  • fr - French
  • nl - Dutch
multipleOptionalN/ASetting multiple will allow the user to select multiple items in this dropdown.
nameRequiredN/AThe name of the form field. This is how the value will be submitted back to the server
readonlyOptionalN/AThis sets the html readonly attribute and controls if the user can change the value
requiredOptional0Set required to '1' if you'd like the form validator to check if this form element has a value before submitting
sizeOptionalN/AThe size attribute will be directly passed through to this component and dictates how much items are showing by default.
styleOptionalThe style attribute for the actual form component
titleOptionalN/ASets the title attribute on the select element.
valueOptionalThe current value of the form element

Most of the attributes you see here are just passed through to the actual select element.

See also