jQuery EasyUI 是一套建在 jQuery 之上的 UI 框架,把常用的界面插件打包在一起,從視窗、選單到表格、樹形結構一應俱全,目的是讓後端工程師不必花太多時間在樣式上,也能快速做出可用的後台頁面。以下示範以 1.5 版為基準。
form 組件提供了一組操作表單欄位的方法,例如 ajax 提交、load、clear 等;提交前還可以先呼叫 validate 做有效性檢查,避免髒資料送到後端。
最直接的用法是寫普通的 form 標籤,再搭配 validatebox 做欄位驗證:
<form id="ff" method="post">
<div>
<label for="name">Name:</label>
<input class="easyui-validatebox" type="text" name="name" data-options="required:true" />
</div>
<div>
<label for="email">Email:</label>
<input class="easyui-validatebox" type="text" name="email" data-options="validType:'email'" />
</div>
</form>
接著用 jQuery 把它變成異步提交,onSubmit 負責提交前的攔截,success 處理回傳結果:
$('#ff').form({
url: '...',
onSubmit: function(){
// 提交前想做的事,回傳 false 可中止提交
},
success: function(data){
// 後端回應的處理
}
});
// 觸發提交
$('#ff').submit();
DataGrid 以表格形式呈現資料,同時內建選擇、排序、分群、分頁與編輯等能力。它的設計目標是縮短開發時間,工程師不需要具備太多 CSS 知識也能上手;單元格合併、多層表頭、凍結欄與凍結頁尾都只是其中一小部分功能。
用 HTML 標籤宣告欄位:
<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">編碼</th>
<th data-options="field:'name',width:100">名稱</th>
<th data-options="field:'price',width:100,align:'right'">價格</th>
</tr>
</thead>
</table>
或者純用 jQuery 初始化,把後端資料載入進來:
$('#dg').datagrid({
url: 'datagrid_data.json'
});
要讓表格可以直接在頁面上編輯,需要先載入 edatagrid 擴充套件,載入完成後才能使用。
在表頭的欄位定義裡透過 editor 屬性指定編輯器型別:
<table id="tt" style="width:600px;height:200px" title="Editable DataGrid" singleSelect="true">
<thead>
<tr>
<th field="itemid" width="100" editor="{type:'validatebox',options:{required:true}}">Item ID</th>
<th field="productid" width="100" editor="text">Product ID</th>
<th field="listprice" width="100" align="right" editor="{type:'numberbox',options:{precision:1}}">List Price</th>
<th field="unitcost" width="100" align="right" editor="numberbox">Unit Cost</th>
<th field="attr1" width="150" editor="text">Attribute</th>
</tr>
</thead>
</table>
初始化時把新增、修改、刪除的提交位址一起帶上:
$('#tt').edatagrid({
url: 'datagrid_data.json',
saveUrl: '...',
updateUrl: '...',
destroyUrl: '...'
});
完成之後,雙擊任一列即可進入編輯狀態。幾個高頻方法:
$('#tt').edatagrid("saveRow"); // 儲存目前編輯列並送出到伺服器
$('#tt').edatagrid("destroyRow"); // 刪除目前選取的列
$('#tt').edatagrid("addRow"); // 新增一個空白列
以上就是 EasyUI 三個最常用的組件——表單、DataGrid 與可編輯表格的基本用法,掌握它們,一般的後台維護頁面基本就夠用了。