Javascript must be activated for this page!
NOTE: This page is from an older version, see the latest version
here .
A combobox / dropdown-list / selectbox plugin.
This plugin converts <combobox> elements in the current
xml into several internal <layer> container, scrollarea and textfield elements.
Additionally it's also possible to add and remove combobox elements also dynamically.
The xml-only implementation allows many ways of customizing (design and functionality).
Due the xml-only plugin code it works automatically the same for HTML5 and Flash.
It's possible to use this plugin as replacement for the old
combobox.swf / combobox.js plugins, the action interfaces are
the same.
The combobox can be placed on the screen or within other layers like a normal layer
element - e.g. by using the align , edge , x , y and parent settings.
If no width is set, the width will be determined automatically by the design settings and
the largest item caption.
Setting the height is not possible,
the height will be always set automatically.
Attribute nameType Default value
design String "default"
Select the design for the combobox.
Here a predefined design or own custom one can be selected.
Available designs are:
default - white boxes with a shadow and black text.
vtour - vtourskin.xml look, dark-blue background with white text.
If no setting or an invalid setting is used, the 'default' design will be used.
A custom design can be created by a <combobox_design> element.
For more please see here:
Combobox Custom Designs
Attribute nameType Default value
callonclickafterclose Boolean false
Define when the onclick event of the items should be called:
true (default) - call onclick delayed after closing the combobox.
false - call instantly, this can be necessary when changing browser settings that require a direct user-interaction, e.g. like switching to the fullscreen mode.
Attribute name (read only) Type Default value
selecteditemindex int
The index (0-n) of the current selected item.
Attribute nameType Default value
onchange String
This event will be called when the current selected item will be changed.
Attribute name (read only) Type Default value
item Array
Array of the items, only for read-access.
Access by: layer[cbname].item[itemname].*
To get the number of items: layer[cbname].item.count
Attribute nameType Default value
item[itemname].caption String
The caption text for the item.
The item itself is a textfield
and so it's possible to use also html/css code here.
Attribute name (read only) Type Default value
item[itemname].itemlayername String
Attribute name (read only) Type Default value
item[itemname].itemlayer Object
Attribute nameType Default value
item[itemname].oninit String
This event will be called when creating the item.
The calling-scope will be item textfield layer element.
Could be used to dynamically style the item element on creation.
Attribute nameType Default value
item[itemname].onclick String