28. EasyUI Combo 组合

扩展自 $.fn.validatebox.defaults。通过 $.fn.combo.defaults 重写默认的 defaults。

组合（combo）是在 html 页面上显示一个可编辑的文本框和下拉面板。它是用于创建其他复杂的组合组件（比如：组合框 combobox、组合树 combotree、组合网格 combogrid，等等）的基础组件。

依赖

validatebox
panel

用法

组合（combo）可以使用 javascript 从 <select> 或 <input> 元素进行创建。请注意，从标记创建组合（combo）是无效的。

<input id="cc" value="001">
$('#cc').combo({
    required:true,
    multiple:true
});

属性

该属性扩展自验证框（validatebox），下面是为组合（combo）添加的属性。

名称	类型	描述	默认值
width	number	组件的宽度。	auto
height	number	组件的高度。该属性自版本 1.3.2 起可用。	22
panelWidth	number	下拉面板的宽度。	null
panelHeight	number	下拉面板的高度。	200
multiple	boolean	定义是否支持多选。	false
selectOnNavigation	boolean	定义当通过键盘导航项目时是否选择项目。该属性自版本 1.3.3 起可用。	true
separator	string	多选时文本的分隔符。	,
editable	boolean	定义用户是否可以往文本域中直接输入文字。	true
disabled	boolean	定义是否禁用文本域。	false
readonly	boolean	定义组件是否只读。该属性自版本 1.3.3 起可用。	false
hasDownArrow	boolean	定义是否显示向下箭头的按钮。	true
value	string	默认值。
delay	number	从最后一个键的输入事件起，延迟进行搜索。	200
keyHandler	object	当用户按键后调用的函数。

keyHandler:

默认的 keyHandler 定义如下：

keyHandler: {
	up: function(){},
	down: function(){},
	enter: function(){},
	query: function(q){}
}

事件

名称	参数	描述
onShowPanel	none	当下拉面板显示的时候触发。
onHidePanel	none	当下拉面板隐藏的时候触发。
onChange	newValue, oldValue	当文本域的值改变的时候触发。

方法

该方法扩展自验证框（validatebox），下面是为组合（combo）添加的方法。

名称	参数	描述
options	none	返回选项（options）对象。
panel	none	返回下拉面板对象。
textbox	none	返回文本框对象。
destroy	none	销毁组件。
resize	width	调整组件的宽度。
showPanel	none	显示下拉面板。
hidePanel	none	隐藏下拉面板。
disable	none	禁用组件。
enable	none	启用组件。
readonly	mode	启用/禁用只读模式。该方法自版本 1.3.3 起可用。
validate	none	验证输入的值。
isValid	none	返回验证结果。
clear	none	清除组件的值。
reset	none	重置组件的值。该方法自版本 1.3.2 起可用。
getText	none	获取输入的文本。
setText	none	设置文本值。
getValues	none	获取组件的值的数组。
setValues	none	设置组件的值的数组。
getValue	none	获取组件的值。
setValue	none	设置组件的值。

用法实例：

readonly:

$('#cc').combo('readonly');		// enable readonly mode
$('#cc').combo('readonly', true);	// enable readonly mode
$('#cc').combo('readonly', false);	// disable readonly mode