JSComboBox
GMSC 2013/2014 Javascript API | Overview • Form • Events • Types • Utility Functions • client-side Validation • Conditions • Interaction with SmartClient • Cookbook • Cheatsheet |
Form Models | BaseModel • FormModel • TabModel • GroupModel • Field Models • ActionModel |
Field Models | AutoComplete • CheckBox • ComboBox • DatePicker • DateTimePicker • EditableComboBox • Editor • FilePicker • Grid • Hyperlink • Image • Label • Password • Radio • TextArea • TextField • |
The Combobox widget allows the selection from a larger set of options. Note that the combobox widget was designed for holding about 100 items, a larger set of items can lead to performance issues. You should consider using the Autocomplete Widget in this case. This widget is available since
.Methods & Properties
This widget inherits all methods and properties from BaseModel. The following methods have a different behaviour:
fill(values, selectedValue)
pre-fills the widget with a list of values and optionally selects the selected Value.
Parameters
{Array}
values
An array of objects containing the list-of-value items. Each item must have the following structure {id: 'valueOfItem', name: 'Label shown in the widget'}
{String}
selectedValue
(optional) value that should be pre-selected.
Example
Fill a list-of-value-widget (AutoComplete, Combobox or editable Combobox) with two items and pre-select the second one:
var lovWidget = IG.form.getItemById('LOV'); lovWidget.fill([{id: '1', name: 'First Item'},{id: '2', name: 'Second Item'}], '2');