DataGrid用法及属性

使用方法（Usage Example）

从现有的表单元素创建数据表格，定义在html中的行，列和数据。

  
      
          
            Code  
            Name  
            Price  
          
      
      
          
            001name12323  
          
          
            002name24612  
          
      
  

 

通过

标记创建的DataGrid。嵌套的                          Code               Name               Price                    

标签定义的列的表。

  

 

使用JavaScript创建数据表格。

  


$('#dg').datagrid({   
    url:'datagrid_data.json',   
    columns:[[   
        {field:'code',title:'Code',width:100},   
        {field:'name',title:'Name',width:100},   
        {field:'price',title:'Price',width:100,align:'right'}   
    ]]   
});  

查询数据填充数据表格。

$('#dg').datagrid('load', {   
    name: 'easyui',   
    address: 'ho'  
});  

 

数据更改与服务器交互，刷新当前数据。

$('#dg').datagrid('reload');    // reload the current page data  

数据表格属性（DataGrid Properties）

属性继承控制面板，以下是数据表格独有的属性。

名称	类型	描述	默认值
columns	array	数据表格列配置对象，查看列属性以获取更多细节。	undefined
frozenColumns	array	跟列属性一样，但是这些列固定在左边，不会滚动。	undefined
fitColumns	boolean	设置为true将自动使列适应表格宽度以防止出现水平滚动。	false
autoRowHeight	boolean	定义设置行的高度，根据该行的内容。设置为false可以提高负载性能。	true
toolbar	array,selector	数据表格顶部面板的工具栏。可能的值： 1）数组，每个工具选项和链接按钮相同。 2）选择显示的工具栏。 在一个 的标签定义工具栏: $('#dg').datagrid({ toolbar: '#tb' }); 通过数组定义工具栏: $('#dg').datagrid({ toolbar: [{ iconCls: 'icon-edit', handler: function(){alert('edit')} },'-',{ iconCls: 'icon-help', handler: function(){alert('help')} }] });	null
striped	boolean	设置为true将交替显示行背景。	false
method	string	请求远程数据的方法类型。	post
nowrap	boolean	设置为true，当数据长度超出列宽时将会自动截取。	true
idField	string	表明该列是一个唯一列。	null
url	string	一个用以从远程站点请求数据的超链接地址。	null
loadMsg	string	当从远程站点载入数据时，显示的一条快捷信息。	Processing, please wait …
pagination	boolean	设置true将在数据表格底部显示分页工具栏。	false
rownumbers	boolean	设置为true将显示行数。	false
singleSelect	boolean	设置为true将只允许选择一行。	false
checkOnSelect	boolean	如果为true，该复选框被选中/取消选中，当用户点击某一行上。如果为false，该复选框仅检查/取消选中，当用户点击完全的复选框。 此属性是1.3版本。	true
selectOnCheck	boolean	如果设置为true，单击一个复选框，将始终选择行。如果为false，不会选择行选中该复选框。 此属性是1.3版本。	true
pagePosition	string	定义的分页栏的位置。可用的值有 'top','bottom','both'。 此属性是可自1.3版本。	bottom
pageNumber	number	当设置分页属性时，初始化分页码。	1
pageSize	number	当设置分页属性时，初始化每页记录数。	10
pageList	array	当设置分页属性时，初始化每页记录数列表。	[10,20,30,40,50]
queryParams	object	当请求远程数据时，发送的额外参数。 示例: $('#dg').datagrid({ queryParams: { name: 'easyui', subject: 'datagrid' } });	{}
sortName	string	当数据表格初始化时以哪一列来排序。	null
sortOrder	string	定义排序顺序，可以是'asc'或者'desc'（正序或者倒序）。	asc
remoteSort	boolean	定义是否通过远程服务器对数据排序。	true
showFooter	boolean	定义是否显示行底（如果是做统计表格，这里可以显示总计等）。	false
rowStyler	function	返回样式，如：'background:red'，function有2个参数： index：行索引，从0开始. row：对应于该行记录的对象。 示例: $('#dg').datagrid({ rowStyler: function(index,row){ if (row.listprice>80){ return 'background-color:#6293BB;color:#fff;'; } } });
loader	function	定义如何从远程服务器加载数据。返回false可以取消该操作。这个函数接受以下参数： param: 参数对象传递到远程服务器。 success(data): 回调函数将被调用成功检索的数据。 error():回调函数将被调用失败时检索数据。	json loader
loadFilter	function	返回过滤的数据显示。该函数需要一个参数'data'，表示原始数据。您可以更改源数据的标准数据格式。此函数必须返回标准数据对象中包含的“total”和“rows”的属性。 示例: // removing 'd' object from asp.net web service json output $('#dg').datagrid({ loadFilter: function(data){ if (data.d){ return data.d; } else { return data; } } });
editors	object	定义当编辑一行时的编辑模式。	predefined editors
view	object	定义数据表格的视图。	default view

 

列属性（Column Properties）

数据表格的列是一个对象数组，即这个对象中的元素也是一个数组（js中数组是对象）。 对象数组中的每一个元素都是可配置的对象，每个可配置对象定义一个列。

 

示例:

columns:[[   
    {field:'itemid',title:'Item ID',rowspan:2,width:80,sortable:true},   
    {field:'productid',title:'Product ID',rowspan:2,width:80,sortable:true},   
    {title:'Item Details',colspan:4}   
],[   
    {field:'listprice',title:'List Price',width:80,align:'right',sortable:true},   
    {field:'unitcost',title:'Unit Cost',width:80,align:'right',sortable:true},   
    {field:'attr1',title:'Attribute',width:100},   
    {field:'status',title:'Status',width:60}   
]]  

 

名称	类型	描述	默认值
title	string	列标题。	undefined
field	string	列字段。	undefined
width	number	列宽。	undefined
rowspan	number	表明一个单元格跨几行。	undefined
colspan	number	表明一个单元格跨几列。	undefined
align	string	表明如何对其列数据，可选值：'left'，'right'，'center'。	undefined
sortable	boolean	设置为true允许对该列排序。	undefined
resizable	boolean	设置为true允许该列被缩放。	undefined
hidden	boolean	设置为true将隐藏列。	undefined
checkbox	boolean	设置为true将显示复选框。	undefined
formatter	function	格式化单元格函数，有3个参数： value：字段的值。 rowData：行数据。 rowIndex：行索引。 示例: $('#dg').datagrid({ columns:[[ {field:'userId',title:'User', width:80, formatter: function(value,row,index){ if (row.user){ return row.user.name; } else { return value; } } } ]] });	undefined
styler	function	单元格样式函数，返回样式字符串装饰表格如'background:red'，function有3个参数： value：字段值。 rowData：行数据。 rowIndex：行索引。 示例: $('#dg').datagrid({ columns:[[ {field:'listprice',title:'List Price', width:80, align:'right', styler: function(value,row,index){ if (value < 20){ return 'background-color:#ffee00;color:red;'; } } } ]] });	undefined
sorter	function	T自定义字段排序函数，有2个参数： a：该列的第一个值。 b：该列的第二个值。 示例: $('#dg').datagrid({ remoteSort: false, columns: [[ {field:'date',title:'Date',width:80,sortable:true,align:'center', sorter:function(a,b){ a = a.split('/'); b = b.split('/'); if (a[2] == b[2]){ if (a[0] == b[0]){ return (a[1]>b[1]?1:-1); } else { return (a[0]>b[0]?1:-1); } } else { return (a[2]>b[2]?1:-1); } } } ]] });	undefined
editor	string,object	表明编辑类型。如果属性是字符串类型表示编辑类型，如果是对象则包含2个参数： type：字符串，编辑类型，可选值：text，textarea，checkbox，numberbox，validatebox，datebox，combobox，combotree。 options：对象，对象于编辑类型的编辑器属性。	undefined

 

编辑器（Editor）

使用$.fn.datagrid.defaults.editors重载默认值。

 

每个编辑器都有以下方法:

名称	属性	描述
init	container, options	初始化编辑器并返回目标对象。
destroy	target	注销编辑器。
getValue	target	获取编辑框的值。
setValue	target , value	设置编辑框的值。
resize	target , width	调整编辑器

如下代码将定义一个文本编辑器:

$.extend($.fn.datagrid.defaults.editors, {   
    text: {   
        init: function(container, options){   
            var input = $('').appendTo(container);   
            return input;   
        },   
        getValue: function(target){   
            return $(target).val();   
        },   
        setValue: function(target, value){   
            $(target).val(value);   
        },   
        resize: function(target, width){   
            var input = $(target);   
            if ($.boxModel == true){   
                input.width(width - (input.outerWidth() - input.width()));   
            } else {   
                input.width(width);   
            }   
        }   
    }   
});  

 

数据表格视图（DataGrid View）

使用$.fn.datagrid.defaults.view重载默认值。

视图是一个告诉数据表格如何呈现行记录的对象，对象必须定义以下方法:

名称	属性	描述
render	target, container, frozen	当数据载入时调用。 target: DOM对象，数据网格对象。 container: 行记录容器。 frozen: 是否呈现固定容器。
renderFooter	target, container, frozen	这是一个可选函数用以展现行底。
renderRow	target, fields, frozen, rowIndex, rowData	这是一个可选函数，它可以被render函数调用。
refreshRow	target, rowIndex	定义如何刷新指定的行。
onBeforeRender	target, rows	在视图被呈现之前触发。
onAfterRender	target	在视图被程序之后触发。

 

事件（Events）

事件继承控制面板，以下是数据表格独有的属性。

名称	属性	描述
onLoadSuccess	data	当数据载入成功时触发。
onLoadError	none	当载入远程数据发生错误时触发。
onBeforeLoad	param	在请求载入数据之前触发，如果返回false将取消载入。
onClickRow	rowIndex, rowData	当用户点击行时触发，参数如下： rowIndex：被点击的行索引，从0开始。 rowData：对应于被点击的行的记录。
onDblClickRow	rowIndex, rowData	当用户双击一行时触发，参数如下： rowIndex：被点击的行索引，从0开始。 rowData：对应于被点击的行的记录。
onClickCell	rowIndex, field, value	当用户点击单元格时触发。
onDblClickCell	rowIndex, field, value	当用户双击单元格时触发。 示例: // when double click a cell, begin editing and make the editor get focus $('#dg').datagrid({ onDblClickCell: function(index,field,value){ $(this).datagrid('beginEdit', index); var ed = $(this).datagrid('getEditor', {index:index,field:field}); $(ed.target).focus(); } });
onSortColumn	sort, order	当用户对列排序时触发，参数如下： sort：排序字段名称。 order：排序顺序。
onResizeColumn	field, width	当用户调整列宽时触发。
onSelect	rowIndex, rowData	当用户选择一行是触发，参数如下： rowIndex：被选择的行索引，从0开始。 rowData：对应于被选择行的记录。
onUnselect	rowIndex, rowData	当用户取消选择一行时触发，参数如下： rowIndex：被取消选择的行索引，从0开始。 rowData：对应于被取消选择行的记录。
onSelectAll	rows	当用户选择所有行时触发。
onUnselectAll	rows	当用户取消选择所有行时触发。
onCheck	rowIndex,rowData	当用户选中行时触发，参数包含： rowIndex：选中行的索引，从0开始 rowData：选中的行对应的记录 此属性是1.3版本。
onUncheck	rowIndex,rowData	当用户取消选中行时触发，参数包含： rowIndex：取消选中行的索引，从0开始 rowData：未经检查的行对应的记录 此属性是1.3版本。
onCheckAll	rows	当用户检查所有行时触发。此属性是1.3版本。
onUncheckAll	rows	用户取消所有行时触发。此属性是1.3版本。
onBeforeEdit	rowIndex, rowData	当用户开始编辑一行时触发，参数如下： rowIndex：正在编辑的行索引，从0开始。 rowData：对应于正在编辑的行的记录。
onAfterEdit	rowIndex, rowData, changes	当用户编辑完成时触发，参数如下： rowIndex：正在编辑的行索引，从0开始。 rowData：对应于正在编辑的行的记录。 changes：被改变的字段内容，对应方式为字段：值。
onCancelEdit	rowIndex, rowData	当用户取消编辑行时触发，参数如下： rowIndex：正在编辑的行索引，从0开始。 rowData：对应于正在编辑的行的记录。
onHeaderContextMenu	e, field	当数据表格的列标题被鼠标右键单击时触发。
onRowContextMenu	e, rowIndex, rowData	当一行被鼠标右键单击时触发。

 

方法（Methods）

 

名称	属性	描述
options	none	返回属性对象。
getPager	none	返回页面对象。
getPanel	none	返回控制面板对象。
getColumnFields	frozen	返回列字段，如果设置了frozen属性为true，将返回固定列的字段名。 示例: var opts = $('#dg').datagrid('getColumnFields'); // get unfrozen columns var opts = $('#dg').datagrid('getColumnFields', true); // get frozen columns
getColumnOption	field	返回特定的列属性。
resize	param	缩放和布局。
load	param	载入并显示第一页的记录，如果传递了'param'参数，它将会覆盖查询参数属性的值。通过传递一些参数，通常做一个查询，这个方法可以被称为从服务器加载新数据。 $('#dg').datagrid('load',{ code: '01', name: 'name01' });
reload	param	重载记录，跟'load'方法一样但是重载的是当前页的记录而非第一页。
reloadFooter	footer	重载行底记录。 示例: // update footer row values and then refresh var rows = $('#dg').datagrid('getFooterRows'); rows[0]['name'] = 'new name'; rows[0]['salary'] = 60000; $('#dg').datagrid('reloadFooter'); // update footer rows with new data $('#dg').datagrid('reloadFooter',[ {name: 'name1', salary: 60000}, {name: 'name2', salary: 65000} ]);
loading	none	显示载入状态。
loaded	none	隐藏载入状态。
fitColumns	none	让列宽自动适应数据表格的宽度。
fixColumnSize	field	固定列尺寸。如果“field' 参数未指定，将所有列的大小固定。 示例: $('#dg').datagrid('fixColumnSize', 'name'); // fix the 'name' column size $('#dg').datagrid('fixColumnSize'); // fix all columns size
fixRowHeight	index	固定特定列的高度。如果“index' 参数未指定，将所有列的高度固定。
autoSizeColumn	field	自动调整列宽，以适应内容。此方法是1.3版本特有的。
loadData	data	载入本地数据，旧记录将被移除。
getData	none	返回已载入数据。
getRows	none	返回当前页的记录。
getFooterRows	none	返回行底记录。
getRowIndex	row	返回指定行的索引，row参数可以是行记录或者是一个id字段的值。
getChecked	none	返回所有行的复选框已被选中。此方法是1.3版本特有的。
getSelected	none	返回第一个被选择的行记录或null。
getSelections	none	返回所有被选择的行，当没有记录被选择时，将返回一个空数组。
clearSelections	none	取消所有的已选择项。
selectAll	none	选择所有页面的行。
unselectAll	none	取消选择所有页面的行。
selectRow	index	选择一行，行索引从0开始。
selectRecord	idValue	通过传递id参数来选择一行。
unselectRow	index	取消选择一行。
checkAll	none	检查所有页面的行。此方法是1.3版本特有的。
uncheckAll	none	取消检查所有当前页面的行。此方法是1.3版本特有的。
checkRow	index	检查行，行索引从0开始。此方法是1.3版本特有的。
uncheckRow	index	取消检查行，行索引从0开始。此方法是1.3版本特有的。
beginEdit	index	开始编辑一行。
endEdit	index	结束编辑。
cancelEdit	index	取消编辑。
getEditors	index	获取指定行的编辑器，每个编辑器有如下属性： actions：编辑器可以做的行为。 target：目标编辑器jQuery对象。 field：字段名。 type：编辑器类型。
getEditor	options	获取特定的编辑器，options参数有2个属性： index：行索引。 field:字段名。 示例: // get the datebox editor and change its value var ed = $('#dg').datagrid('getEditor', {index:1,field:'birthday'}); $(ed.target).datebox('setValue', '5/4/2012');
refreshRow	index	刷新一行。
validateRow	index	校验指定的行，如果有效返回true。
updateRow	param	更新指定的行，param参数包含如下属性： index：要更新的行索引。 row：新的行数据。 示例: $('#dg').datagrid('updateRow',{ index: 2, row: { name: 'new name', note: 'new note message' } });
appendRow	row	添加一行。 新的行会被添加到最后一个位置: $('#dg').datagrid('appendRow',{ name: 'new name', age: 30, note: 'some messages' });
insertRow	param	插入一个新行，param参数包含如下属性： index：要插入的行索引，如果没有定义则在最后面添加一个新行。 row：行数据。 示例: // insert a new row at second row position $('#dg').datagrid('insertRow',{ index: 1, // index start with 0 row: { name: 'new name', age: 30, note: 'some messages' } });
deleteRow	index	删除一行。
getChanges	type	获取从最后一次提交开始的被修改的所有行，type参数表明修改的类型，可选值：inserted，deleted，updated等 。当没有传递type参数时，返回所有被修改的行。
acceptChanges	none	提交所有修改的数据，提交后的数据将不能再修改或者回滚。
rejectChanges	none	回滚自创建以来或自上次调用AcceptChanges，所有的变化数据。
mergeCells	options	合并单元格，options参数包含如下属性： index：行索引。 field：字段名。 rowspan：整合单元格要跨的行数。 colspan：整合单元格要跨的列数。
showColumn	field	显示特定的列。
hideColumn	field	隐藏特定的列。

 

  1     /////////////////////////////////////////////
  2         //初始化数据
  3     function initGrid()
  4         {  
  5             $('#grid').datagrid({
  6                 width:'100%',    
  7                 height:'auto',
  8                 nowrap: true,
  9                 striped: true,
 10                 fitColumns:false,
 11                 url:'${contextPath}/cardGift/cardGift.do?method=getCardGiftList&activeId=${information.cardGiftActive.activeId}',
 12                 queryParams:queryParam,
 13                 remoteSort:false,
 14                 //Grid对应的主键列
 15                 idField:'',
 16                 singleSelect:true,
 17                 columns:[[
 18                         {field:'serial',title:'',width:15,checkbox:true},
 19                         {field:'activeName',title:'活动名称',width:50,sortable:true},
 20                         {field:'giftGoodId',title:'赠品商品编码',width:80},
 21                         {field:'goodsName',title:'商品名称',width:120},
 22                         {field:'giftCodeTotal',title:'赠品码生成数量',width:100},
 23                         {field:'genCodeNumber',title:'已生成赠品码数量',width:100},
 24                         {field:'startTime',title:'赠品发放起始时间',width:125},
 25                         {field:'endTime',title:'赠品发放结束时间',width:125},
 26                         {field:'memo',title:'备注',width:120}
 27                 ]],
 28                 pagination:true,
 29                 rownumbers:true,
 30                 toolbar:[
 31                 '-',{
 32                     id:'btnClearSelections',
 33                     text:'修改活动商品',
 34                     iconCls:'icon-edit',
 35                     handler:function(){
 36                         editData();
 37                     }
 38                 },'-',{
 39                     id:'btnDel',
 40                     text:'删除活动商品',
 41                     iconCls:'icon-no',
 42                     handler:function(){
 43                         deleteData();
 44                     }
 45                 },
 46                 '-',{
 47                     id:'btnClearSelections',
 48                     text:'清除选择',
 49                     iconCls:'icon-cut',
 50                     handler:function(){
 51                         $('#grid').datagrid('clearSelections');
 52                         //设置选中值
 53                         document.addForm.reset();
 54                         $('#giftCodeTotal').val("0");
 55                         $('#memoData').html("");
 56                         $('#submitBtn').html("确认提交");
 57                         $('#submitBtn').attr('onclick',"addSubmit('insert');");
 58                     }
 59                 }],
 60                 onLoadError:function(){
 61                     XW_dialog.alert('','加载数据失败！');
 62                 }
 63                 
 64             });
 65             
 66             //设置分页控件  
 67             var p = $('#grid').datagrid('getPager');  
 68             $(p).pagination(PAGE_TEMPLATE);
 69         }
 70         
 71         
 72         function editData(){
 73             var row = $('#grid').datagrid("getSelections");
 74             if($(row).length < 1 || $(row).length > 1)
 75             {
 76                 XW_dialog.alert('',"请选择要查看的记录，只能选取单行！");
 77                 return ;
 78             }
 79             //设置默认选中
 80             $('#goodsSelect').combogrid('grid').datagrid('selectRecord',row[0].giftGoodId);
 81             $('#goodsSelect').hide();
 82             //设置选中值
 83             $('#giftCodeTotal').val(row[0].giftCodeTotal);
 84             $('#memoData').html(row[0].memo);
 85             $('#submitBtn').html("更新");
 86             $('#submitBtn').attr('onclick',"addSubmit('update');");
 87             $('#resetBtn').hide();
 88             
 89         }
 90         
 91         
 92         function deleteData(){
 93         var data = $('#grid').datagrid("getSelections");
 94         //删除 
 95         var delurl = "${contextPath}/cardGift/cardGift.do?method=deleteCardGift&activeId="+data[0].activeId+"&giftGoodId="+data[0].giftGoodId;
 96         //发送删除请求
 97         $.ajax({
 98            type: "POST",
 99            dataType:'json',
100            url: delurl,
101            success: function(msg){
102              if(msg.success)
103                 {
104                     //保存回调函数使用的数据
105                     XW_dialog.addData('callbackData',msg.map);
106                     //删除成功
107                     XW_dialog.tips(msg.errorMsg, 3);
108                     deleteCallBack();
109                 }
110                 else
111                 {
112                     XW_dialog.alert('',msg.errorMsg);
113                 }
114            }
115     });
116 }    
117         
118         
119         //删除记录回调函数，默认调用刷新记录方法，
120         function deleteCallBack(){
121             reloadGrid("grid");
122         }
123