jQuery 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)添加的属性。

名称类型描述默认值
widthnumber组件的宽度。auto
heightnumber组件的高度。该属性自版本 1.3.2 起可用。22
panelWidthnumber下拉面板的宽度。null
panelHeightnumber下拉面板的高度。200
multipleboolean定义是否支持多选。false
selectOnNavigationboolean定义当通过键盘导航项目时是否选择项目。该属性自版本 1.3.3 起可用。true
separatorstring多选时文本的分隔符。,
editableboolean定义用户是否可以往文本域中直接输入文字。true
disabledboolean定义是否禁用文本域。false
readonlyboolean定义组件是否只读。该属性自版本 1.3.3 起可用。false
hasDownArrowboolean定义是否显示向下箭头的按钮。true
valuestring默认值。
delaynumber从最后一个键的输入事件起,延迟进行搜索。200
keyHandlerobject当用户按键后调用的函数。默认的 keyHandler 定义如下:
keyHandler: {
	up: function(){},
	down: function(){},
	enter: function(){},
	query: function(q){}
}

事件

名称参数描述
onShowPanelnone当下拉面板显示的时候触发。
onHidePanelnone当下拉面板隐藏的时候触发。
onChangenewValue, oldValue当文本域的值改变的时候触发。

方法

该方法扩展自验证框(validatebox),下面是为组合(combo)添加的方法。

名称参数描述
optionsnone返回选项(options)对象。
panelnone返回下拉面板对象。
textboxnone返回文本框对象。
destroynone销毁组件。
resizewidth调整组件的宽度。
showPanelnone显示下拉面板。
hidePanelnone隐藏下拉面板。
disablenone禁用组件。
enablenone启用组件。
readonlymode启用/禁用只读模式。该方法自版本 1.3.3 起可用。 用法实例:
$('#cc').combo('readonly');		// enable readonly mode
$('#cc').combo('readonly', true);	// enable readonly mode
$('#cc').combo('readonly', false);	// disable readonly mode
optionsnone验证输入的值。
optionsnone返回验证结果。
optionsnone清除组件的值。
optionsnone重置组件的值。该方法自版本 1.3.2 起可用。
optionsnone获取输入的文本。
optionsnone设置文本值。
optionsnone获取组件的值的数组。
optionsnone设置组件的值的数组。
optionsnone获取组件的值。
optionsnone设置组件的值。