扩展自 $.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: { 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'); // 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 | 设置组件的值。 |