萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jqGrid 多選與獲取選中行數據完整實戰:multiselect、selarrrow、getCell

啟用多選功能


$('#listId').jqGrid({
  // ... 其他配置
  multiselect: true,        // 顯示複選框列
  multiselectWidth: 30,     // 複選框列寬度
  multiboxonly: false,      // true: 僅點擊複選框選中,false: 點擊行選中
  // 可選:多選鍵修飾符
  // multikey: 'ctrlKey'     // 按住 Ctrl 鍵多選
});

獲取選中行數據

1. 獲取選中行 ID 數組


const rowIds = $('#listId').jqGrid('getGridParam', 'selarrrow');
// 返回: ["rowid1", "rowid2", ...] 或 []

2. 遍歷獲取各字段值


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:'進行中'}, ...]

3. 獲取完整行數據對象


const rowIds = $('#listId').jqGrid('getGridParam', 'selarrrow');
const fullRows = rowIds.map(id => $('#listId').jqGrid('getRowData', id));
// 包含該行所有列數據 (含隱藏列)

設置行選中狀態

按行 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 支持。

copyright © 萬盛學電腦網 all rights reserved