ComboTreeGrid(树形表格下拉框)

扩展自$.fn.combo.defaults和$.fn.treegrid.defaults。使用$.fn.combotreegrid.defaults重写默认值对象。(该组件自1.5版开始可用)

树形表格下拉框结合了可编辑文本框控件和下拉树形表格面板控件,该控件允许用户快速从树形表格中选择一条或多条记录。

 

 

依赖关系

 

使用案例

创建树形表格下拉框

1. 使用标签创建一个数据表格下拉框。

  1. <input class="easyui-combotreegrid" data-options="
  2. width:'100%',
  3. panelWidth:500,
  4. label:'Select Item:',
  5. labelPosition:'top',
  6. url:'treegrid_data1.json',
  7. idField:'id',
  8. treeField:'name',
  9. columns:[[
  10. {field:'name',title:'Name',width:200},
  11. {field:'size',title:'Size',width:100},
  12. {field:'date',title:'Date',width:100}
  13. ]]">

2. 使用Javascript通过已经定义的<select>或<input>标签来创建数据表格下拉框。

  1. <input id="cc" name="name">
  2. $(function(){
  3.     $('#cc').combogrid({
  4.         value:'006',
  5.         width:'100%',
  6.         panelWidth:500,
  7.         label:'Select Item:',
  8.         labelPosition:'top',
  9.         url:'treegrid_data1.json',
  10.         idField:'id',
  11.         treeField:'name',
  12.         columns:[[
  13.             {field:'name',title:'Name',width:200},
  14.             {field:'size',title:'Size',width:100},
  15.             {field:'date',title:'Date',width:100}
  16.         ]]
  17.     });
  18. });  
 

属性

树形表格下拉框的属性扩展自combo(自定义下拉框)和treegrid(树形表格),combotreegrid新增属性如下:

属性名 属性值类型 描述 默认值
idField string ID字段名称。 null
textField string 要显示在文本框中的文本字段 null
limitToGrid boolean 限制输入的值只能是树形表格中的值。 false


 

事件

数据表格下拉框事件完全扩展自combo(自定义下拉框)和datagrid(数据表格)。

 

方法

数据表格下拉框的方法扩展自combo(自定义下拉框),数据表格下拉框新增或重写的方法如下:

方法名 方法参数 描述
options none 返回属性对象。
grid none 返回数据表格对象。下面的例子显示了如何获取选择的行:
var g = $('#cc').combogrid('grid');	// 获取数据表格对象
var r = g.datagrid('getSelected');	// 获取选择的行
alert(r.name);
setValue value 设置组件值。

代码示例:

$('#cc').combogrid('setValue', '002');
$('#cc').combogrid('setValue', {id:'003',name:'name003'});
setValues values 设置组件值数组。

代码示例:

$('#cc').combogrid('setValues', ['001','007']);
$('#cc').combogrid('setValues', ['001','007',{id:'008',name:'name008'}]);
clear none 清除组件的值。

关注编程学问公众号