「在彈出的清單視窗中勾選多筆,關閉後把結果帶回父頁面」是很常見的互動。難點在於勾選狀態必須被完整累積——包含跨頁勾選、取消勾選、全選與取消全選。以下示範以 Map 為核心的做法。
在 datagrid 上掛 onCheck、onUncheck、onSelectAll、onUnselectAll 四個事件,每次變動就同步更新一個 Map,再把 Map 序列化成 JSON 字串寫進隱藏欄位。父頁面只要讀那個隱藏欄位即可。
用 Map 而非陣列的理由是:以 id 為 key 能天然去重,且取消勾選時移除的成本是 O(1),不必搜尋整個陣列。
onCheck: function (rowIndex, rowData) {
if (rowIndex > -1) {
var userId = rowData.id;
if (!dataMap.containsKey(userId)) {
dataMap.put(userId, rowData);
$("input[name=selectData]").val(JSON.stringify(dataMap));
}
}
},
onUncheck: function (rowIndex, rowData) {
if (rowIndex > -1) {
var userId = rowData.id;
if (dataMap.containsKey(userId)) {
dataMap.remove(userId);
$("input[name=selectData]").val(JSON.stringify(dataMap));
}
}
},
onSelectAll: function (rows) {
for (var i = 0; i < rows.length; i++) {
var rowData = rows[i];
var userId = rowData.id;
if (!dataMap.containsKey(userId)) {
dataMap.put(userId, rowData);
$("input[name=selectData]").val(JSON.stringify(dataMap));
}
}
},
onUnselectAll: function (rows) {
for (var i = 0; i < rows.length; i++) {
var rowData = rows[i];
var userId = rowData.id;
if (dataMap.containsKey(userId)) {
dataMap.remove(userId);
$("input[name=selectData]").val(JSON.stringify(dataMap));
}
}
}
var f = parent.$.modalDialogTwo.handler.find('#selectForm');
var selectData = f.find('input[name="selectData"]').get(0).value;
if (!selectData) {
parent.$.messager.alert('提示', "請選擇一條記錄!");
return;
}
var map = jQuery.parseJSON(selectData);
if (map.elements.length > 0) {
var nos = new Array();
var names = new Array();
for (var i = 0; i < map.elements.length; i++) {
var data = map.elements[i];
nos.push(data.key);
names.push(data.value.name);
}
}
只處理 onCheck 與 onUncheck 是不夠的。全選時 EasyUI 觸發的是 onSelectAll,單筆勾選才觸發 onCheck;兩者不會互相觸發。少了全選的處理,使用者按下全選後 Map 裡一筆都沒有,帶回去就是空的。這是最常漏掉的一塊。
而 rowIndex > -1 的判斷是在過濾「表頭被勾選」這種特殊情況,避免把表頭當成資料列處理。
迴圈內反覆序列化。全選一百筆就會呼叫 JSON.stringify 一百次。應把寫入動作移到迴圈之外,只做一次。
map.elements 的假設很危險。程式碼假設序列化後的結構有 elements 屬性、每項有 key 與 value,這是某個特定 Map 實作的產物。若 dataMap 是原生 Map,JSON.stringify 會得到 {}——因為原生 Map 的內容不是可列舉屬性。使用前務必確認實作,或改用明確的結構:
// 建議:直接用陣列,清楚且無序列化疑慮
var selected = [];
function sync() {
$('input[name=selectData]').val(JSON.stringify(selected));
}
onCheck: function (idx, row) {
if (!selected.some(r => r.id === row.id)) selected.push(row);
sync();
},
onUncheck: function (idx, row) {
selected = selected.filter(r => r.id !== row.id);
sync();
},
onSelectAll: function (rows) {
rows.forEach(r => { if (!selected.some(s => s.id === r.id)) selected.push(r); });
sync();
},
onUnselectAll: function (rows) {
const ids = rows.map(r => r.id);
selected = selected.filter(r => !ids.includes(r.id));
sync();
}
隱藏欄位是權宜之計。它依賴表單序列化,在表單被 JS 攔截送出時就失效了。更穩定的做法是直接把選取值存在 JS 變數中,送出時自行組進 AJAX 的參數。若使用較新版的 EasyUI,也可考慮 datagrid('getChecked') 搭配 idField 設定,讓元件自己管理勾選狀態。