Mashup Builder > Widgets > Standard Widgets > Dropdown Widget (Themable)
Dropdown Widget (Themable)
* 
This widget replaces the Combo Box view of the legacy List widget.
The Dropdown widget enables you to add a dropdown user interface element and its options in the mashup. A mashup user can select from the dropdown.
* 
The Dropdown is available as a standard widget in the platform and as a web component that can be imported from an SDK.
The properties of the Dropdown widget are listed below.
Property Name
Description
Base Type
Default Value
Bindable? (Y/N)
Localizable? (Y/N)
HintText
Displays placeholder text that explains what should be entered in the field.
STRING
Select..
Y
Y
Label
The text that is displayed as the widget label.
STRING
n/a
Y
Y
LabelAlignment
Enables you to align the label to the left, right or center.
STRING
Left
Y
N
Alignment
Enables you to align the text items to the left, right or center in the dropdown list.
STRING
Left
Y
N
ClearSelectionItem
Adds a blank selection item to the drop-down list. Enables the user to clear a selection.
BOOLEAN
True
Y
N
ClearSelectionLabel
Specifies a custom text for the clear selection item in the drop-down list. It is set to None by default.
STRING
None
Y
Y
Disabled
Use this property to disable the widget in the mashup. The widget is displayed in the mashup but you cannot click it.
BOOLEAN
False
Y
N
ShowListFilter
Enables you to add a filter inside the dropdown list and allows you to filter the list items at run time.
BOOLEAN
False
N
N
FilterHintText
Displays a hint text for the dropdown list filter.
STRING
n/a
Y
Y
ListMaxHeight
Enables you to set a maximum height for the drop-down list that is displayed.
A scroll bar is added in the display if the number of items in the drop-down list is more than the list height that is set.
NUMBER
n/a
Y
N
StateField
The infotable that represents the state of the line items in the dropdown list.
This property can be used to enable or disable the line items in a dropdown list.
INFOTABLE
n/a
N
N
MultiSelect
Enables the user to select multiple items in the dropdown list.
BOOLEAN
False
N
N
AutoSelectFirstRow
Enables you to set the first row as the selected option in the dropdown list.
* 
This property is available to you when the MultiSelect property is not selected.
BOOLEAN
False
N
N
RowHeight
Enables you to set the row height for the single line.
NUMBER
34
Y
N
CustomClass
Enables you to define the CSS class to apply to the top div of the widget. Multiple classes can be entered, separated by space.
STRING
n/a
Y
N
TabSequence
The sequence of the widgets in which they are highlighted when the user presses Tab key.
NUMBER
n/a
N
N
Data
The infotable source.
INFOTABLE
n/a
Y
N
DisplayField
The infotable field that represents the data value.
n/a
n/a
N
N
ValueField
The field that is used for SelectedText.
n/a
n/a
N
N
SelectedText
Enables you to select an item in the list.
STRING
n/a
Y
Y
SelectedItems
The infotable source for the selected items in the list.
INFOTABLE
n/a
Y
N
ListFormat
Opens a dialog box that enables you to specify the rendered and the formatting rules for the widget data. In ThingWorx 9.1 and later, you can also apply state formatting to the widget.
Renderer and State Formatting
n/a
N
N
TooltipField
Displays a tooltip text when you hover over the label associated with the dropdown and the currently selected value in the dropdown.
* 
This property is available for ThingWorx version 9.3.0 and later.
STRING
n/a
Y
Y
TooltipIcon
Sets an icon image for the tooltip of the dropdown widget.
* 
This property is available for ThingWorx version 9.3.0 and later.
MEDIA ENTITY
n/a
N
N
Was this helpful?