Select element

This element appears as a dropdown containing a list of options which correspond to an underlying value. You can manually specify a static list of options, or populate the dropdown dynamically from a callback response array.

See examples

Properties

• ID: is used to refer to the element in mappings, etc.

• Field type: specifies what kind of data this element represents.

  Note

  This property is only available in the CyberApp enablement form and the Customer enablement form.

  • Connection settings: indicates that this information will be sent to the ISV servers but does not need to uniquely identify a user and is not sensitive information that must be stored and sent in a special way.
  • Additional settings

• Label

  An optional element label. It can be displayed in the element or above the element.

  For more details, see the Size and the Show label outside properties, below.

• Width

  • Fit (see examples)

    Sets the width according to the combination of the Size and Label properties.
  • Fill (see examples)

    Uses all of the available width.

    For more information, see Element distribution.
• Placeholder

  An optional text, displayed when the user has not selected an option, to hint what data the user might want to select.

  If the placeholder text is longer than the element can accomodate, it is truncated.

• Size

  • Default

    Standard height and width, with the label inside the field.

    If Label is longer than the default element width can accomodate, the label is truncated. (see examples)
  • Small

    Reduced height and width, with the label located above the field.

    If Label is longer than the default element width can accomodate, the element width increases accordingly. (see examples)

• Show label outside

  The label text displays above the element.

  This is the default behavior for elements with Size property of Small, so this property has no effect on them.

  Tip

  To avoid truncation of a long label for an element with Size property of Default, enable this property. The element will expand accordingly to accomodate the long label.

  

• Multi-select

  Allows selection of multiple options. Otherwise, only one option can be selected.

  

• Clearable

  Adds an icon to clear the selected option(s).

  

• Dynamic width

  Increases the width of the dropdown options list to accomodate any options with a long Label or Comment, which would otherwise be truncated.

  

• Filterable

  Adds a search field in the options list to filter the options list.

  

• Options section specifies the list of options in the select dropdown. There are two ways to specify the select dropdown options:

  • Static.

    For more information, see Building a static select option list.
  • Callback.

    For more information, see Building a dynamic select option list.

Examples

Width and size examples

Note

The text for each element example is Label property text.

Long label examples

In this section

• Building a static select option list
• Building a dynamic select option list