Combo 组合
扩展自 $.fn.validatebox.defaults 。 用 $.fn.combo.defaults 重写了 defaults 。
依赖
- validatebox
- panel
用法
1. <input id="cc" value="001">
2. <select id="cc"></select>
1. $('#cc').combo({
2. required:true,
3. multiple:true
4. });
特性
其特性扩展自 validatebox，下列是为 combo 增加的特性：
| 名称 | 类型 | 说明 | 默认值 |
| Width | number | 组件的宽度。 | auto |
| panelWidth | number | 下拉面板的宽度。 | null |
| panelHeight | number | 下拉面板的高度。 | 200 |
| multiple | boolean | 定义是否支持多选。 | false |
| separator | string | 多选时文本的分隔符。 | , |
| editable | boolean | 定义是否用户可以往文本域中直接输入文字。 | true |
| disabled | boolean | 定义是否禁用文本域。 | 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 | 启用组件。 |
| validate | none | 验证输入的值。 |
| isValid | none | 返回验证结果。 |
| clear | none | 清除组件的值。 |
| getText | none | 获取输入的文本。 |
| setText | text | 设置文本值。 |
| getValues | none | 获取组件的值的数组。 |
| setValues | values | 设置组件的值的数组。 |
| getValue | none | 获取组件的值。 |
| setValue | value | 设置组件的值。 |
时间： 2024-10-01 12:58:00