jQuery EasyUI API 中文文档 - 组合框(ComboBox)-阿里云开发者社区

开发者社区> 开发与运维> 正文

jQuery EasyUI API 中文文档 - 组合框(ComboBox)

简介: ComboBox 组合框 扩展自 $.fn.combo.defaults。 用 $.fn.combobox.defaults 重写了 defaults。 依赖 combo 用法 1.

ComboBox 组合框

扩展自 $.fn.combo.defaults $.fn.combobox.defaults 重写了 defaults

依赖

  • combo

用法

1. <select id="cc" name="dept" style="width:200px;">

2. <option value="aa">aitem1</option>

3. <option>bitem2</option>

4. <option>bitem3</option>

5. <option>ditem4</option>

6. <option>eitem5</option>

7. </select>

1. <input id="cc" name="dept" value="aa">

1. $('#cc').combobox({  

2.     url:'combobox_data.json',  

3.     valueField:'id',  

4.     textField:'text'

5. }); 

json 数据格式的示例

1. [{  

2. "id":1,  

3. "text":"text1"

4. },{  

5. "id":2,  

6. "text":"text2"

7. },{  

8. "id":3,  

9. "text":"text3",  

10. "selected":true

11. },{  

12. "id":4,  

13. "text":"text4"

14. },{  

15. "id":5,  

16. "text":"text5"

17. }] 

特性

其特性扩展自 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

取消选择指定的选项。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章