jqGrid 的批次操作建立在兩個設定上:開啟多選模式,以及從 selarrrow 取出被勾選的列 id 陣列。以下把流程走完。
$("#List").jqGrid({
url: 'data.json',
datatype: 'json',
colNames: ['Name', 'Age'],
colModel: [
{ name: 'name', index: 'name', width: 150 },
{ name: 'age', index: 'age', width: 80 }
],
multiselect: true, // 加上這行,最左側會出現核取方塊欄
pager: '#pager',
height: 'auto'
});
加上 multiselect: true 後,jqGrid 會自動在 grid 最左邊插入一欄核取方塊,並在標題列提供全選用的核取方塊,不需要自己刻。
var rowData = jQuery('#List').jqGrid('getGridParam', 'selarrrow');
if (rowData.length) {
for (var i = 0; i < rowData.length; i++) {
var name = jQuery('#List').jqGrid('getCell', rowData[i], 'name');
// 'name' 是 colModel 中定義的屬性名
alert(name);
}
}
selarrrow 回傳的是被勾選列的 id 陣列(這些 id 來自 grid 資料的 rowid,不是資料庫主鍵,除非你刻意讓兩者一致)。因此要拿到每一列的實際欄位值,還得再用 getCell(列id, 欄位名) 逐一取出。
var ids = $("#List").jqGrid('getGridParam', 'selarrrow');
var rows = [];
for (var i = 0; i < ids.length; i++) {
rows.push($("#List").jqGrid('getRowData', ids[i])); // 回傳該列所有欄位的物件
}
console.log(rows); // [{ name:'...', age:'...' }, ...]
getRowData 一次回傳整列的所有可見欄位,比連續呼叫 getCell 簡潔,也少幾次內部查找。若只需要 id 清單去呼叫刪除 API,直接送 ids 陣列即可。
jQuery('#List').jqGrid('setSelection', '5'); // 5 是該列的 rowid
這個方法會勾選指定 id 的列,同時回傳該 id。若要取消勾選,沒有專用方法,可以操作核取方塊:
$("#List").jqGrid('setSelection', '5');
$("#jqg_List_5").prop("checked", false); // 取消單一列的勾選
換頁後 selarrrow 會被清空。預設行為下,翻頁或重新查詢會重設選取狀態。若需要跨頁保留勾選,得自行維護一個 id 集合,在 loadComplete 時把集合內的 id 逐一 setSelection 還原。
全選只選當前頁。表頭那個核取方塊的作用範圍是当前頁的資料,不是全部結果集。若規格要求「全選所有符合條件的資料」,應該傳送查詢條件給後端,由後端處理,而不是在前端硬湊 id 清單。