Select

Displays a single-selection list box. Values for the list box must be supplied by the allowedValues property.

Properties for this display component are:

• allowedValues– Specifies the list of selectable values for display in the list box.

• allowedOthers– When set, specifies that initial values that were not on the allowedValues list should be tolerated and silently added to the list.

• autoSelect– When set to true, this property causes the first value in the allowedValues list to be automatically selected if the initial value for the field is null.

• multiple– When set to true, allows more than one value to be selected.

• nullLabel– Specifies the text that displays at the top of the list box when no value is selected.

• optionGroupMap– Allows the selector to render options in groups using the <optgroup> tag. Format the map such that the keys of the maps are the group labels, and the elements are lists of items to be selectable. (Values must be members of allowedValues in order to render.)

• size– (Optional) Specifies the maximum number of rows to display. If the number of rows exceeds this size, a scroll bar is added.

• sorted– When set to true, causes the values in the list to be sorted.

• valueMap– Maps raw values to displayed values.

The component supports the command and onChange properties.

Example

<Field name=’city’ type=’string’>
   <Display class=’Select’>
      <Property name=’title’ value=’City’/>
      <Property name=’allowedValues’>
         <List>
            <String>Austin</String>
            <String>Portland</String>
            <String>New York</String>
         </List>
      </Property>
   </Display>
</Field>