Selector

Provides a single- or multi- valued field (similar to Text or ListEditor components, respectively) with search fields below. After a search is executed, Waveset displays results beneath the search fields and populates the results into the value field.

Unlike other container components, Selector has a value (the field we are populating with search results). The contained fields are typically search criteria fields. Selector implements a property to display the contents of the search results.

Properties include:

• fixedWidth– Specifies whether the component should have a fixed width (same behavior as Multiselect). (Boolean)

• multivalued– Indicates whether the value is a List or a String. (The value of this property determines whether a ListEditor or Text field is rendered for the value). (Boolean)

• allowTextEntry– Indicates whether values must be selected from the supplied list or can be entered manually. (Boolean)

• valueTitle– Specifies the label to use on the value component. (String)

• pickListTitle– Specifies the label to use on the picklist component. (String)

• pickValues– the available values in the picklist component (if null, the picklist is not shown). (List)

• pickValueMap– a map of display labels for the values in the picklist. (Map or List)

• searchLabel– Labels the button next to the input text field with the supplied text. If not set, the text defaults to “...”.

• sorted– Indicates that the values should be sorted in the picklist (if multivalued and not ordered, the value list will also be sorted). (Boolean)

• clearFields– Lists the fields that should be reset when the Clear button is selected. (List)

The following properties are valid only in a multi-valued component:

• ordered– Indicates that the order of values is important. (Boolean)

• allowDuplicates– Indicates whether the value list can contain duplicates. (Boolean)

• valueMap– Provides a map of display labels for the values in the list. (Map)

These properties are valid only in a single-valued component:

• nullLabel– Specifies a label to use to indicate a value of null. (String)