Synopsis
- LZX: datacombobox
- JavaScript: datacombobox
- Type: Class
- Access: public
- Topic: Components.Laszlo Components
- Declared in: lps/components/lz/datacombobox.lzx
Description
A combination box or "combobox" is a common UI element for displaying a pop-up list associated with a text field.
OpenLaszlo includes two variants of the combobox:
comboboxhas list items defined inline.datacombobox, has list items determined by a dataset, which may be local or remote.
The selected
text of the combobox is displayed within the text field. This field
is an LzInputText field if the
editable of the combobox is true
(the default), or a static LzText field if it
is false.
The number of items shown in the combobox can be set using the
shownitems attribute. If there are more items
available than are shown, a scrollbar will be created
automatically.
The list of items in a combobox can be created explicity using the
textlistitem tag with assigned
text and value
attributes.
Example 43. simple datacombobox
<canvas bgcolor="#EAEAEA" height="200">
<include href="lz/datacombobox.lzx"/>
<dataset name="items">
<item value="item0" >item 0</item>
<item value="item1" >item 1</item>
<item value="item2" >item 2</item>
<item value="item3" >item 3</item>
<item value="item4" >item 4</item>
<item value="item5" >item 5</item>
<item value="item6" >item 6</item>
<item value="item7" >item 7</item>
<item value="item8" >item 8</item>
<item value="item9" >item 9</item>
<item value="item10" >item 10</item>
<item value="item11" >item 11</item>
</dataset>
<view x="20" y="20" >
<simplelayout/>
<text> local data, defaulttext="choose one.." </text>
<datacombobox id="cbox1"
width="130"
shownitems="6"
defaulttext="Choose One..."
itemdatapath="items:/item"/>
</view>
</canvas>
A dropdown list of selectable items.