|
This themable widget was listed as Beta in the ThingWorx 8.4.X release. This widget replaces the Combo Box view of the legacy List widget.
|
|
The Dropdown is available as a standard widget in the platform and as a web component that can be imported from an SDK.
|
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 runtime.
|
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.
|
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
|
This property is used to apply a specific render for the data.
|
n/a
|
n/a
|
N
|
N
|