jQuery EasyUI 表单插件 _ Combo 组合


jQuery EasyUI 插件 jQuery EasyUI 插件

扩展自 $.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
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 插件 jQuery EasyUI 插件

    0 个评论

    要回复文章请先登录注册