首页 » jQuery EasyUI »
网站地图

jQuery EasyUI 表单插件 - Combogrid 组合网格

扩展自 $.fn.combo.defaults 和 $.fn.datagrid.defaults。通过 $.fn.combogrid.defaults 重写默认的 defaults。

组合网格（combogrid）把可编辑的文本框和下拉数据网格面板结合起来，用户可以从下拉数据网格面板中快速查找和选择。组合网格（combogrid）提供了选择某个项目的键盘导航支持。

依赖

  • combo
  • datagrid

用法

创建组合网格（combogrid）

1、从标记创建组合网格（combogrid）。

  1. <select id="cc" class="easyui-combogrid" name="dept" style="width:250px;"
  2.     data-options="
  3.     panelWidth:450,
  4.     value:'006',
  5.     idField:'code',
  6.     textField:'name',
  7.     url:'datagrid_data.json',
  8.     columns:[[
  9.     {field:'code',title:'Code',width:60},
  10.     {field:'name',title:'Name',width:100},
  11.     {field:'addr',title:'Address',width:120},
  12.     {field:'col4',title:'Col41',width:100}
  13.     ]]
  14.     "></select>

2、使用 javascript 从已有的 <select> 或 <input> 元素创建。

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

  1. $('#cc').combogrid({
  2.     panelWidth:450,
  3.     value:'006',
  4.     idField:'code',
  5.     textField:'name',
  6.     url:'datagrid_data.json',
  7.     columns:[[
  8.     {field:'code',title:'Code',width:60},
  9.     {field:'name',title:'Name',width:100},
  10.     {field:'addr',title:'Address',width:120},
  11.     {field:'col4',title:'Col41',width:100}
  12.     ]]
  13.     });

自动完成功能

让我们为组合网格（combogrid）提那家自动完成功能。下拉数据网格将根据用户输入显示可能的结果。

  1. $('#cc').combogrid({
  2.     delay: 500,
  3.     mode: 'remote',
  4.     url: 'get_data.php',
  5.     idField: 'id',
  6.     textField: 'name',
  7.     columns: [[
  8. 		{field:'code',title:'Code',width:120,sortable:true},
  9. 		{field:'name',title:'Name',width:400,sortable:true}
  10.     ]]
  11. });

在服务器端，'q' 参数必须首先被检索。用户可以查询数据库，然后返回一个 JSON 格式的 sql 结果到浏览器。

get_data.php:

  1. $q = isset($_POST['q']) ? $_POST['q'] : ''; // the request parameter
  2. // query database and return JSON result data
  3. $rs = mysql_query("select * from item where name like '$q%'");
  4. echo json_encode(...);

属性

该属性扩展自组合（combo）和数据网格（datagrid），下面是为组合网格（combogrid）添加的属性。

名称类型描述默认值
loadMsgstring当数据网格（datagrid）加载远程数据时显示的消息。null
idFieldstringid 的字段名。null
textFieldstring显示在文本框中的 text 字段名。null
modestring定义当文本改变时如何加载数据网格（datagrid）数据。如果组合网格（combogrid）从服务器加载就设置为 'remote'。当设置为 'remote' 模式时，用户输入的值将会被作为名为 'q' 的 http 请求参数发送到服务器，以获取新的数据。local
filterfunction(q, row)定义当 'mode' 设置为 'local' 时如何选择本地数据。返回 true 则选择该行。 代码实例： 
  1. $('#cc').combogrid({
  2. 	filter: function(q, row){
  3. 		var opts = $(this).combogrid('options');
  4. 		return row[opts.textField].indexOf(q) == 0;
  5. 	}
  6. });
100

事件

该事件扩展自组合（combo）和数据网格（datagrid）。

方法

该方法扩展自组合（combo），下面是为组合网格（combogrid）添加或重写的方法。

名称参数描述
optionsnone返回选项（options）对象。
gridnone返回数据网格（datagrid）对象。下面的实例显示如何取得选中的行： 
  1. var g = $('#cc').combogrid('grid');	// get datagrid object
  2. var r = g.datagrid('getSelected');	// get the selected row
  3. alert(r.name);
setValuesvalues设置组件值的数组。 代码实例： 
  1. $('#cc').combogrid('setValues', ['001','007']);
setValuevalue设置组件的值。 代码实例： 
  1. $('#cc').combogrid('setValue', '002');
clearnone清除组件的值。