本文可以當做api來使用
動態編輯用到DOM解析的話參考
http://www.w3school.com.cn/xmldom/dom_htmlcollection.asp
使用方法（Usage Example）
從現有的表單元素創建數據表格，定義在html中的行，列和數據。
- <table class="easyui-datagrid">
- <thead>
- <tr>
- <th data-options="field:'code'">Code</th>
- <th data-options="field:'name'">Name</th>
- <th data-options="field:'price'">Price</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>001</td><td>name1</td><td>2323</td>
- </tr>
- <tr>
- <td>002</td><td>name2</td><td>4612</td>
- </tr>
- </tbody>
- </table>
通過<TABLE>標記創建的DataGrid。嵌套的<TH>標簽定義的列的表。
- <table class="easyui-datagrid" style="width:400px;height:250px"
- data-options="url:'datagrid_data.json',fitColumns:true,singleSelect:true">
- <thead>
- <tr>
- <th data-options="field:'code',width:100">Code</th>
- <th data-options="field:'name',width:100">Name</th>
- <th data-options="field:'price',width:100,align:'right'">Price</th>
- </tr>
- </thead>
- </table>
使用JavaScript創建數據表格。
- <table id="dg"></table>
- $('#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）選擇顯示的工具欄。 在一個<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 |
列屬性（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 = $('<input type="text" class="datagrid-editable-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