The DojoComboBox widget defines a presentation that includes
a visible value, which represents the current selection, and a dropdown
list of values. This widget is based on the Dojo dijit.form.ComboBox
definition.
Properties
- editable
- A boolean that indicates whether the user can change the text
in the current selection. The changed text becomes the current selection
but neither adds to the preset list of values nor changes a listed
value permanently. The default is true.
- pageSize
- The number of values that are displayed in the dropdown list.
- value
- The current selection. You can get and set this value, which is
processed as a string and, in keeping with EGL conversion rules, can
be a number.
When the Dojo combo box is the view component of a
controller, the value that the view receives from the model component
of the controller can take precedence over the value that you assign
to the value property of the combo box.
For details on controllers, see “Rich UI validation and formatting.”
- values
- An array of strings. The content is the list of all values that
are available to the user.
If you assign to the value property
a value that is not in the array, the assigned value will be visible;
but if the user selects a value from the dropdown list, the assigned
value is no longer available.