Insert Form Element: Select Box

Select Boxes are sometimes referred to as "drop-down-lists". They allow visitors to make a selection from a wide range of options, without these options taking up vast amounts of space on the webpage
Options
List ItemsThis is the area in which you can enter all the options that will appear in your "drop-down-list". Enter one item per line. By default, the list item's internal value (the value that will be sent when the form is submitted) is the same as the value displayed to the visitor. To have a different internal value to the value displayed, precede the list item with [value] where value is the internal value, and is not displayed to visitors:
Example
List Items:[#FF0000] Red
[#00FF00] Green
[#0000FF] Blue
Code Generated:<SELECT>
  <OPTION VALUE="#FF0000"> Red
  <OPTION VALUE="#00FF00"> Green
  <OPTION VALUE="#0000FF"> Blue
</SELECT>
Browser Output:

You can also specify whether an option is selected by default by adding a "*" after the item. More than one option can be selected by default if the "Allow multiple selections" option is enabled...
Example
List Items:Red
Green *
Blue
Code Generated:<SELECT>
  <OPTION VALUE="Red"> Red
  <OPTION VALUE="Green" SELECTED> Green
  <OPTION VALUE="Blue"> Blue
</SELECT>
Browser Output:
You can "group" similar items togther, with a heading, by enclosing them in "{" and "}" brackets:
Example
List Items:{ Basic Colors
Red
Green
Blue
}
{ More Colors
Cyan
Magenta
Yellow
}
Browser Output:

Initial Items VisibleBy default, drop-down-lists only display one option at a time. Specifying an "Initial Items Visible" number higher than 1 will display more options at any one time:
Example
Initial Items Visible:1
Browser Output:
Initial Items Visible:2
Browser Output:
Name of Select BoxAn internal name for the select box. This name can then be used to access the select box through scripting
DisabledIs the select box disabled when the page loads. A value of a "disabled" select box cannot be changed by visitors to the page. (Scripts on your page can still access disabled elements and enable them as necessary)
Allow multiple selectionsBy default, only one item from a drop-down-list may be selected by a visitor, unless "Allow multiple selections" is enabled, then visitors can select more than one option from the list by holding down their "Ctrl" key whilst clicking options. Try it out below:
ExampleHold down "Ctrl" whilst clicking to select more than one option...
EventsAttach scripted "events" which trigger upon certain user actions/events - Read More about Events
Style ClassAttach a previously defined Style Class to your select boxes to further customize their appearance
ListsThe "Lists" button allows quick access to a number of common drop-down-lists to save you having to manually enter long lists. List include Countries, Timezones, Years, Months, Days, and more...
StylesThe "Styles" button allows you to further customize the appearance of select boxes

Next Topic: Insert Form Element: Input Box >