含义
自定义下拉框显示一个可编辑的文本框和下拉面板在html页面。这是构建其他复杂的组合部件(如:combobox,combotree,combogrid等)之前需要构建的最基本的组件。
依赖
用法
<input id="cc" value="001">
$('#cc').combo({
required:true,
multiple:true
});
属性(扩展自validatebox)
属性名 |
类型 |
含义 |
默认值 |
width |
number |
组件的宽度 |
auto |
height |
number |
组件的高度 |
22 |
panelWidth |
number |
下拉面板宽度 |
null |
panelHeight |
number |
下拉面板高度 |
200 |
panelMinWidth |
number |
下拉面板最小宽度 |
null |
panelMaxWidth |
number |
下拉面板最大宽度 |
null |
panelMinHeight |
number |
下拉面板最小高度 |
null |
panelMaxHeight |
number |
下拉面板最大高度 |
null |
panelAlign |
string |
left,right |
200 |
multiple |
boolean |
定义是否支持多选 |
false |
selectOnNavigation |
boolean |
是否允许使用键盘导航来选择项目 |
true |
separator |
string |
在多选的时候使用何种分隔符进行分割 |
, |
editable |
boolean |
是否可以直接输入文本到字段中 |
true |
disabled |
boolean |
是否显示向下箭头按钮 |
true |
value |
string |
字段的默认值 |
delay |
number |
最后一次输入事件与执行搜索之间的延迟间隔 |
200 |
keyHandler |
object |
在用户按下键的时候调用一个函数 |
事件
事件名 |
属性 |
含义 |
onSHowPanel |
none |
当下拉面板显示的时候触发 |
onHidePanel |
none |
当下拉面板隐藏的时候触发 |
onChange |
newValue,oldValue |
当字段值改变的时候触发 |
方法
方法名 |
参数 |
含义 |
options |
none |
返回属性对象 |
panel |
none |
返回下拉面板对象 |
textbox |
none |
返回文本框对象 |
destroy |
none |
销毁该组件 |
resize |
width |
调整组件宽度 |
showPanel |
none |
显示下拉面板 |
hidePanel |
none |
隐藏下拉面板 |
disable |
none |
禁用组件 |
enable |
none |
启用组件 |
readonly |
none |
启用/禁用只读模式 |
validate |
none |
验证输入的值 |
iValid |
none |
返回验证结果 |
clear |
none |
清除控件的值 |
reset |
none |
重置控件的值 |
getText |
none |
获取输入的文本 |
setText |
text |
设置输入的文本 |
getValues |
none |
获取组件值的数组 |
setValues |
values |
设置组件值的数组 |
getValue |
none |
获取组件的值 |
setValue |
value |
设置组建的值 |