combo（自定义下拉框）

含义

自定义下拉框显示一个可编辑的文本框和下拉面板在html页面。这是构建其他复杂的组合部件（如：combobox,combotree,combogrid等）之前需要构建的最基本的组件。

依赖

• textbox
• panel

用法

$('#cc').combo({    
    required:true,    
    multiple:true   
}); 

属性（扩展自validatebox）

属性名	类型	含义	默认值
width	number	组件的宽度	auto
height	number	组件的高度	22
panelWidth	number	下拉面板宽度	null
panelHeight	number	下拉面板高度	200
panelMinWidth	number	下拉面板最小宽度	null
panelMaxWidth	number	下拉面板最大宽度	null
panelMinHeight	number	下拉面板最小高度	null
panelMaxHeight	number	下拉面板最大高度	null
panelAlign	string	left,right	200
multiple	boolean	定义是否支持多选	false
selectOnNavigation	boolean	是否允许使用键盘导航来选择项目	true
separator	string	在多选的时候使用何种分隔符进行分割	,
editable	boolean	是否可以直接输入文本到字段中	true
disabled	boolean	是否显示向下箭头按钮	true
value	string	字段的默认值
delay	number	最后一次输入事件与执行搜索之间的延迟间隔	200
keyHandler	object	在用户按下键的时候调用一个函数

事件

事件名	属性	含义
onSHowPanel	none	当下拉面板显示的时候触发
onHidePanel	none	当下拉面板隐藏的时候触发
onChange	newValue，oldValue	当字段值改变的时候触发

方法

方法名	参数	含义
options	none	返回属性对象
panel	none	返回下拉面板对象
textbox	none	返回文本框对象
destroy	none	销毁该组件
resize	width	调整组件宽度
showPanel	none	显示下拉面板
hidePanel	none	隐藏下拉面板
disable	none	禁用组件
enable	none	启用组件
readonly	none	启用/禁用只读模式
validate	none	验证输入的值
iValid	none	返回验证结果
clear	none	清除控件的值
reset	none	重置控件的值
getText	none	获取输入的文本
setText	text	设置输入的文本
getValues	none	获取组件值的数组
setValues	values	设置组件值的数组
getValue	none	获取组件的值
setValue	value	设置组建的值