jqGrid 要支援多列勾選,只要一個設定,但取值與設定選取的 API 名稱不太直覺,值得記下來。
$("#List").jqGrid({
// ...
multiselect: true
});
加上這個屬性後,表格最左側會自動多出一欄核取框,表頭那格則是「全選」。
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);
}
}
這裡有兩個 API:selarrrow 是儲存所有已選 row id 的陣列參數,用 getGridParam 取出;getCell(rowId, colName) 則是依列 id 與欄位名取得該格的值。
只取最後點選的那一列時,改用 selrow(單數):
var id = jQuery('#List').jqGrid('getGridParam', 'selrow');
jQuery('#List').jqGrid('setSelection', '5');
參數 '5' 是該列的 row id,不是列序號。這點很容易搞混:jqGrid 的 id 通常來自資料,除非有另外指定,否則不會等於畫面上的第幾列。
別忘了 gridComplete 或 loadComplete。 資料是 AJAX 載入的,若在頁面初始化時立刻呼叫 setSelection,那時候表格還是空的,選取不會生效。正確做法是在 loadComplete 回呼裡處理。
取得整列資料有更省事的方法。 若需要的是完整一筆 row,用 getRowData(rowId) 會直接回傳 key-value 物件,不必逐一欄位呼叫 getCell。
另外提醒,jqGrid 有商業授權考量,自由軟體版本(free version)自 4.7 之後轉為以 MIT 為基礎的 Guriddo 版本,商用前請確認授權條款;新專案也可以考慮呼声更高的替代方案如 ag-Grid 或 Tabulator。