panelWidth(下拉框宽度)
panelHeight(下拉框高度)
multiple(可多选) separator(分隔条) editable(可编辑) disabled(禁用) hasDownArrow(下拉图标) value(值) delay(延迟)
number(数字) number(数字) boolean(布尔型) string(字符串) boolean(布尔型) boolean(布尔型) boolean(布尔型) string(字符串) number(数字)
下拉框的宽度。 下拉框的高度。 定义是否支持多选。
当支持多选时,用以分隔文本的字符。
定义用户是否可以直接向组合框输入内容。
定义是否禁用输入框。 定义是否显示下拉按钮。 默认值。
最后一次输入事件与搜索(自动完成)之间的延迟间隔。
null 200 false , true false true
200
keyHandler(按键助手) object(对象)
当用户按下一个键位时调用的函数,默认的按键助手定义如下:
keyHandler: { up: function(){}, down: function(){}, enter: function(){}, query: function(q){} }
事件
名称 onShowPanel none 参数 描述 当显示下拉面板的时候触发。 onHidePanel onChange 方法
none newValue, oldValue 当隐藏下拉面板的时候触发。 当组合框的值发生改变时触发。 方法继承表单验证,以下是只读组合框独有的方法。
名称 options panel textbox destroy resize showPanel hidePanel disable enable validate isValid clear getText setText getValues setValues getValue setValue
4.4 可装载组合框 可装载组合框
继承$.fn.combo.defaults,使用$.fn.combobox.defaults重载默认值。
参数 none none none none width none none none none none none none none text none values none value
返回属性对象。 返回下拉面板对象。 返回文本框对象。 销毁组件。 调整组件的宽度。 显示下拉面板。 隐藏下拉面板。 禁用组合框。 启用组合框。 验证输入的值。 返回验证结果。 清除组件的值。 获取组合框的值。 设置组合框的值。
返回一个存储下拉面板值的数组。
设置下拉面板的值,参数values是一个数组。 获取下拉面板的值。 设置下拉面板的值。
描述
依赖关系
?
自定义组合框
使用方法
1. 1. 1. $('#cc').combobox({ 2. url:'combobox_data.json', 3. valueField:'id', 4. textField:'text' 5. }); The json data format sample: 1. [{ 2. \:1, 3. \:\ 4. },{ 5. \:2, 6. \:\ 7. },{ 8. \:3, 9. \:\, 10. \:true 11. },{ 12. \:4, 13. \:\ 14. },{ 15. \:5, 16. \:\ 17. }] 属性
继承自定义组合框的属性, 以下是可装载组合框的独有属性。
名称 valueField(值域)
textField(文本域)
mode(模式) url(超链接地址)
method(方法) data(数据)
类型 string(字
符串) string(字符串) string(字符串) string(字符串) string(字符串) array(数组)
描述
绑定到组合框下的数据的值域的名称。
绑定到组合框下数据的文本域的名称。
定义当文本发生改变时,如何载入数据列表。如果组合框要从远程地址载入数据,设置为'remote'。 可供载入数据列表的远程地址。 获取数据的HTTP方法。 将被载入的数据列表。
定义当模式设置为'local'时如何过滤本地数据,function有2个参数: q: 用户输入的文本。 row: 数据列表
返回true将允许显示数据列表。 定义如何返回数据,function有一个参数:row。
默认值 value text
local
null post null
filter(过滤器)
function
(函数)
formatter(格式) 事件
function(函数)
事件继承自定义组合框,以下是可装载组合框的独有事件。
名称 onLoadSuccess onLoadError onSelect 参数 none none record 描述 当远程数据载入成功时触发。 当远程数据载入错误时触发。 当用户选择一个列表项时触发。 onUnselect 方法
record 当用户取消选择一个列表项时触发。 方法继承自定义组合框,以下是可装载组合框独有的或者重载自定义组合框的方法。
名称 options getData loadData reload setValues setValue clear select unselect
4.5 组合树 组合树
继承$.fn.combo.defaults和$.fn.tree.defaults,使用$.fn.combotree.defaults重载默认值。
参数 none none data url values value none value value
返回属性对象。 返回已载入的数据。 载入本地数据列表。 请求远程数据列表。
设置组合框的值,参数values是一个数组。 设置组合框的值。 清除组合框的值。 选择特定的项目。 取消选择特定的项目。
描述
依赖关系