数据表格属性（DataGrid Properties）
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| columns | array | 数据表格列配置对象，查看列属性以获取更多细节。 | undefined |
| frozenColumns | array | 跟列属性一样，但是这些列固定在左边，不会滚动。 | undefined |
| fitColumns | boolean | 设置为true将自动使列适应表格宽度以防止出现水平滚动。 | false |
| autoRowHeight | boolean | 定义设置行的高度，根据该行的内容。设置为false可以提高负载性能。 | true |
| toolbar | array,selector | 数据表格顶部面板的工具栏。可能的值： 1）数组，每个工具选项和链接按钮相同。 2）选择显示的工具栏。 在一个<div>的标签定义工具栏: $('#dg').datagrid({
toolbar: '#tb'
});
<div id="tb">
<a href="#" class="easyui-linkbutton" data-options="iconCls:'icon-edit',plain:true"/a>
<a href="#" class="easyui-linkbutton" data-options="iconCls:'icon-help',plain:true"/a>
</div>
通过数组定义工具栏: $('#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 |