本文示範如何以 jQuery EasyUI 的 datagrid 框架完成資料的新增、刪除與修改,並示範如何擴充套件 datetimebox 編輯元件。由於 datagrid 的屬性眾多,建議盡量用 JS 方式初始化,方便管理。
<script type="text/javascript" charset="utf-8">
var editFlag = undefined;// 設置一個編輯標記
// 因為 layout 框架指向 href 時只取 html 頁面 body 中間的部分,所以該頁面這樣寫即可
$(function () {
$("#dg").datagrid({
url: "GetJson.ashx", // 指向一個一般處理常式或控制器,回傳 Json 格式資料
iconCls: "icon-add",
fitColumns: false, // true 自動適應表格寬度,false 自動匹配大小
idField: 'id', // 標識列,一般設為 id
loadMsg: "正在努力為您加載數據",
pagination: true, // 顯示分頁工具欄
rownumbers: true, // 顯示行號
pageSize: 10, // 讀取分頁條數
pageList: [10, 20, 30], // 可調整每頁顯示的數據
sortName: "name", // 初始化排序欄位
sortOrder: "asc", // 正序
columns: [[
{ field: 'code', title: 'Code', width: 100,
editor: { type: 'validatebox', options: {} } },
{ field: 'name', title: 'Name', width: 100, sortable: true,
editor: { type: 'validatebox', options: { required: true } } },
{ field: 'addr', title: 'addr', width: 100,
editor: { type: 'datetimebox', options: { required: true } } }
]],
toolbar: [{
text: "添加", iconCls: "icon-add",
handler: function () {
if (editFlag != undefined) { $("#dg").datagrid('endEdit', editFlag); }
if (editFlag == undefined) {
$("#dg").datagrid('insertRow', { index: 0, row: { code: '', name: '請輸入姓名', addr: '' } });
$("#dg").datagrid('beginEdit', 0);
editFlag = 0;
}
}
}, '-', {
text: "刪除", iconCls: "icon-remove",
handler: function () {
var rows = $("#dg").datagrid('getSelections');
if (rows.length > 0) {
$.message.confirm("提示", "您確定要刪除這些數據嗎?", function (res) {
if (res) {
var codes = {};
for (var i = 0; i < rows.length; i++) { codes.push(rows[i].code); }
console.info(codes.join(',')); // 拼接字串並傳到後台循環刪除,成功後刷新
}
});
}
}
}, '-', {
text: "修改", iconCls: "icon-edit",
handler: function () {
var rows = $("#dg").datagrid('getSelections');
if (rows.length == 1) {
if (editFlag != undefined) { $("#dg").datagrid('endEdit', editFlag); }
if (editFlag == undefined) {
var index = $("#dg").datagrid('getRowIndex', rows[0]);
$("#dg").datagrid('beginEdit', index);
editFlag = index;
}
}
}
}, '-', {
text: "保存", iconCls: "icon-save",
handler: function () { $("#dg").datagrid('endEdit', editFlag); }
}, '-', {
text: "撤銷", iconCls: "icon-redo",
handler: function () { editFlag = undefined; $("#dg").datagrid('rejectChanges'); }
}, '-'],
onAfterEdit: function (rowIndex, rowData, changes) {
console.info(rowData); // 取得傳到後台的數據,異步到後台新增後刷新
editFlag = undefined;
},
onDblClickCell: function (rowIndex, field, value) {
if (editFlag != undefined) { $("#dg").datagrid('endEdit', editFlag); }
if (editFlag == undefined) {
$("#dg").datagrid('beginEdit', rowIndex);
editFlag = rowIndex;
}
}
});
});
// 點擊查找按鈕觸發事件
function searchFunc() {
$("#dg").datagrid("load", sy.serializeObject($("#searchForm").form()));
}
// 點擊清空按鈕觸發事件
function clearSearch() {
$("#dg").datagrid("load", {});
$("#searchForm").find("input").val("");
}
</script>
頁面結構上,把查詢條件放在 Layout 框架頂部的 north 區,讓樣式盡量貼近 toolbar:
<div class="easyui-tabs" fit="true" border="false"> <div title="數據展示表格" border="false" fit="true"> <div class="easyui-layout" fit="true" border="false"> <div data-options="region:'north',title:'高級查詢'" style="height: 100px; background: #F4F4F4;"> <form id="searchForm"> <table> <tr><th>用戶姓名:</th><td><input name="name" /></td></tr> <tr> <th>創建開始時間</th> <td><input class="easyui-datetimebox" editable="false" name="subStartTime" /></td> <th>創建結束時間</th> <td><input class="easyui-datetimebox" editable="false" name="subEndTime" /></td> <td><a class="easyui-linkbutton" onclick="searchFunc();">查找</a></td> <td><a class="easyui-linkbutton" onclick="clearSearch();">清空</a></td> </tr> </table> </form> </div> <div data-options="region:'center',split:false"> <table id="dg"></table> </div> </div> </div> </div>
datagrid 內建的編輯樣式不含日期時間選擇器,因此我們自行擴充一個 datetimebox:
$(function () {
$.extend($.fn.datagrid.defaults.editors, {
datetimebox: {
init: function (container, options) {
var editor = $('<input />').appendTo(container);
options.editable = false;// 設置不能手動輸入
editor.datetimebox(options);
return editor;
},
getValue: function (target) { return $(target).datetimebox('getValue'); },
setValue: function (target, value) { $(target).datetimebox('setValue', value); },
resize: function (target, width) { $(target).datetimebox('resize', width); },
destroy: function (target) { $(target).datetimebox('destroy'); }
}
});
});
圖示:
整體而言,透過 editFlag 標記目前編輯列,配合 beginEdit/endEdit/insertRow 等方法,就能流暢地完成 datagrid 的增刪改流程;而 onAfterEdit 則是異步存回後台的關鍵時機。