用 EasyUI 的 datagrid 做多選時,checkbox 相關的操作幾乎一定會遇到。以下把幾個高頻場景整理成可直接複用的片段。
datagrid 內建的 getChecked 方法可以直接拿到目前勾選的資料列,回傳陣列:
var rows = $('#datagrid').datagrid('getChecked');
要進一步取欄位值,就遍歷這個陣列,例如 rows[i].id。若表格設定的是 singleSelect,則應改用 getSelected 取得單一物件。
var allFlg = $(".datagrid-header-check").find("input").is(":checked");
這段是判斷表頭那個全選 checkbox 的勾選狀態。實務上常用在「全選之後批次刪除」或「未全選時顯示提示」的情境。
這是最容易出問題的一種情況:使用者開啟彈出層勾選了幾筆,關閉後再打開,之前的勾選卻消失了。解法是自己維護一份已選清單。
思路分三步:
1. 定義一個全域陣列,例如 var checkedIds = []。
2. 每次勾選變動時,把該列的 idField 值存進(或移出)這個陣列。
var checkedIds = [];
// 勾選時記錄
$('#datagrid').datagrid('getChecked'); // 或監聽 onCheck / onUnCheck 事件
$('#datagrid').datagrid({ onCheck: function(index, row){
if (checkedIds.indexOf(row.id) === -1) checkedIds.push(row.id);
}});
// 彈出層關閉前先存起來(也可寫入 localStorage 做跨頁保持)
function saveChecked(){
localStorage.setItem('checkedIds', JSON.stringify(checkedIds));
}
3. 下次開啟彈出層、資料載入完成後,再依這份清單把 checkbox 勾回去:
function restoreChecked(){
var ids = JSON.parse(localStorage.getItem('checkedIds') || '[]');
$('#datagrid').datagrid('load', {
// 帶入過濾條件,或載入後逐筆比對
});
// 資料回來後比對 id 並呼叫 onCheck 效果
$('#datagrid').datagrid('getRows').forEach(function(row){
if (ids.indexOf(row.id) > -1){
$('#datagrid').datagrid('checkRow', row.id);
}
});
}
小提醒:datagrid 在分頁模式下 getChecked 只會回傳目前頁的勾選,跨頁選擇必須自行維護清單(如上)。另外若列頭用 idField 未設定或值重複,回設時會出錯,記得確認 idField 唯一。
以上是 EasyUI checkbox 幾個常見操作的整理,後續若有更多實務技巧會再補上。