jQuery EasyUI 表单插件 - Combo 组合
jQuery EasyUI 插件
扩展自 $.fn.validatebox.defaults。通过 $.fn.combo.defaults 重写默认的 defaults。
组合(combo)是在 html 页面上显示一个可编辑的文本框和下拉面板。它是用于创建其他复杂的组合组件(比如:组合框 combobox、组合树 combotree、组合网格 combogrid,等等)的基础组件。
依赖
用法
组合(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: {
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 起可用。
用法实例:
$( '#cc' ).combo( 'readonly' );
$( '#cc' ).combo( 'readonly' , true );
$( '#cc' ).combo( 'readonly' , false );
|
|
validate |
none |
验证输入的值。 |
isValid |
none |
返回验证结果。 |
clear |
none |
清除组件的值。 |
reset |
none |
重置组件的值。该方法自版本 1.3.2 起可用。 |
getText |
none |
获取输入的文本。 |
setText |
none |
设置文本值。 |
getValues |
none |
获取组件的值的数组。 |
setValues |
none |
设置组件的值的数组。 |
getValue |
none |
获取组件的值。 |
setValue |
none |
设置组件的值。 |
jQuery EasyUI 插件