自定义组合下拉框 - Combo
继承至 $.fn.validatebox.defaults, 覆盖默认值$.fn.combo.defaults
combo显示一个可编辑的文本框和一个下拉panel在html页面上,这个是构建其他复杂combo组件的基础组件,例如combobox,combotree, combogrid, 等等.
Dependencies
- validatebox
- panel
Usage
combo创建可以从<input>和<select>元素使用javascript,注意从标记创建combo是无效的.
Properties
这个属性继承至validatebox,下面是combo的新增属性.
| Name | Type | Description | Default |
|---|---|---|---|
| width | number | 组件的宽度. | auto |
| panelWidth | number | 下拉 panel 宽度. | null |
| panelHeight | number | 下拉 panel 高度. | 200 |
| multiple | boolean | 决定是否支持多项选择. | false |
| separator | string | 多项选择的时候的文本分隔符. | , |
| editable | boolean | 用户是否可以直接输入文本到选择框. | true |
| disabled | boolean | 是否禁用该选择框. | false |
| hasDownArrow | boolean | 定义是否显示下拉箭头按钮. | true |
| value | string | 默认值. | |
| delay | number | 从最后一次输入事件,延时查找. | 200 |
| keyHandler | object | A function called when user press key. The default keyHandler is
defined as: 当用户按下按键的时候这个函数被调用. 默认的 keyHandler定义为: keyHandler: {
up: function(){},
down: function(){},
enter: function(){},
query: function(q){}
}
|
Events
| Name | Parameters | Description |
|---|---|---|
| onShowPanel | none | 当下拉panel显示的时候触发. |
| onHidePanel | none | 当下拉panel隐藏的时候触发. |
| onChange | newValue, oldValue | 当选择框的值发生改变的时候触发 |
Methods
这些方法继承自 validatebox, 以下是combo的新增的方法.
| Name | Parameter | Description |
|---|---|---|
| options | none | 返回options 对象. |
| panel | none | 返回下拉 panel 对象. |
| textbox | none | 返回 textbox 对象. |
| destroy | none | 销毁该组件. |
| resize | width | 调整组件的宽度. |
| showPanel | none | 显示下拉 panel |
| hidePanel | none | 隐藏下拉panel. |
| disable | none | 禁用组件. |
| enable | none | 启用组件. |
| validate | none | 验证输入值. |
| isValid | none | 返回验证的结果 |
| clear | none | 清空组件的值. |
| getText | none | 得到文本框文本. |
| setText | text | 设置文本框值. |
| getValues | none | 得到组件的值数组. |
| setValues | values | 设定组件的值数组. |
| getValue | none | 得到组件值. |
| setValue | value | 设置组件值. |