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)添加的屬性。
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
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 | 设置组件的值。 |
jQuery EasyUI插件