$('#listId').jqGrid({
// ... 其他配置
multiselect: true, // 顯示複選框列
multiselectWidth: 30, // 複選框列寬度
multiboxonly: false, // true: 僅點擊複選框選中,false: 點擊行選中
// 可選:多選鍵修飾符
// multikey: 'ctrlKey' // 按住 Ctrl 鍵多選
});
const rowIds = $('#listId').jqGrid('getGridParam', 'selarrrow');
// 返回: ["rowid1", "rowid2", ...] 或 []
function getSelectedRowsData(gridId, fields) {
const rowIds = $(gridId).jqGrid('getGridParam', 'selarrrow');
if (!rowIds.length) return [];
return rowIds.map(rowId => {
const rowData = {};
fields.forEach(field => {
// getCell 獲取單元格顯示值 (經 formatter 格式化)
rowData[field] = $(gridId).jqGrid('getCell', rowId, field);
// 或 getRowData 獲取原始數據對象
// rowData[field] = $(gridId).jqGrid('getRowData', rowId)[field];
});
return rowData;
});
}
// 使用
const selected = getSelectedRowsData('#listId', ['name', 'amount', 'date', 'status']);
console.log(selected);
// [{name:'項目A', amount:'1000', date:'2023-01-01', status:'進行中'}, ...]
const rowIds = $('#listId').jqGrid('getGridParam', 'selarrrow');
const fullRows = rowIds.map(id => $('#listId').jqGrid('getRowData', id));
// 包含該行所有列數據 (含隱藏列)
$('#listId').jqGrid('setSelection', 'rowid_123', false);
// 第2參數: false=不觸發 onSelectRow 事件
// 選中指定 IDs
const idsToSelect = ['id1', 'id2', 'id3'];
idsToSelect.forEach(id => {
$('#listId').jqGrid('setSelection', id, false);
});
// 全選 (當前頁)
const allIds = $('#listId').jqGrid('getDataIDs');
allIds.forEach(id => $('#listId').jqGrid('setSelection', id, false));
// 取消全選
$('#listId').jqGrid('resetSelection'); // 取消所有選中
$('#listId').jqGrid({
// 單行選中事件
onSelectRow: function(rowid, status, e) {
console.log('行選中狀態:', status); // true/false
const rowData = $(this).jqGrid('getRowData', rowid);
// 業務邏輯...
},
// 全選/取消全選事件 (表頭複選框)
onSelectAll: function(rowids, status) {
console.log('全選狀態:', status, '影響行數:', rowids.length);
},
// 右鍵菜單等其他事件...
});
| 問題 | 解決方案 |
|---|---|
| getCell 返回顯示值而非原始值 | 用 getRowData 獲取原始數據,或在 colModel 定義 unformat 函數 |
| 分頁時選中狀態丟失 | jqGrid 默認不跨頁保持選中,需手動存儲 IDs 到隱藏字段/狀態管理 |
| 大數據量選中卡頓 | 使用 setSelection 批量時加 false 參數防事件觸發,或虛擬滾動模式 |
| 獲取選中行為空 | 確認 multiselect: true,檢查 rowId 是否為字符串 (jqGrid ID 通常為字符串) |
新項目推薦:AG Grid (企業級)、Kendo UI Grid、Tabulator、Handsontable,提供更豐富的選中 API、虛擬滾動、TypeScript 支持。