扩展自 $.fn.combo.defaults。 用 $.fn.combobox.defaults 重写了 defaults。
依赖
- combo
用法
<select id="cc" name="dept" style="200px;"> <option value="aa">aitem1</option> <option>bitem2</option> <option>bitem3</option> <option>ditem4</option> <option>eitem5</option> </select>
或者:
<input id="cc" name="dept" value="aa">
$('#cc').combobox({
url:'combobox_data.json',
valueField:'id',
textField:'text'
});
json 数据格式的示例
[{ "id":1, "text":"text1" },{ "id":2, "text":"text2" },{ "id":3, "text":"text3", "selected":true },{ "id":4, "text":"text4" },{ "id":5, "text":"text5" }]
特性
其特性扩展自 combo,下列是为combobox 增加的特性。
名称 | 类型 | 说明 | 默认值 |
valueField | string | 绑定到 ComboBox 的 value 上的基础数据的名称。 | value |
textField | string | 绑定到 ComboBox 的 text 上的基础数据的名称。 | text |
mode | string | 定义在文本改变时如何加载列表数据。如果组合框从服务器加载就设为 'remote' 。 | local |
url | string | 从远程加载列表数据的 URL 。 | null |
method | string | 用来检索数据的 http method 。 | post |
data | array | 被加载的列表数据。 | null |
filter | function | 定义当 'mode' 设为 'local' 时如何过滤数据。这个函数有两个参数: q:用户输入的文字 row:列表中的行数据。 返回 true 就允许显示该行。 |
|
formatter | function | 定义如何呈现行。这个函数有一个参数:row。 |
事件
其事件扩展自 combo,下列是为 combobox 增加的事件。
名称 |
参数 |
说明 |
onLoadSuccess | none | 当远程数据加载成功时触发。 |
onLoadError | none | 当远程数据加载失败时触发。 |
onSelect | record | 当用户选择一个列表项时触发。 |
onUnselect | record | 当用户取消选择一个列表项时触发。 |
方法
其方法扩展自 combo,下列是为 combobox 追加或重写的方法。
名称 |
参数 |
说明 |
options | none | 返回 options 对象。 |
getData | none | 返回加载的数据。 |
loadData | data | 加载本地列表数据。 |
reload | url | 请求远程的列表数据。 |
setValues | values | 把数组设置为组合框的值。 |
setValue | value | 设置组合框的值。 |
clear | none | 清除组合框的值。 |
select | value | 选择指定的选项。 |
unselect | value | 取消选择指定的选项。 |
?
风流涕淌 翻译。不当之处,敬请指正。转载请保留出处!