DIV CSS 佈局教程網

jqGrid 多選全選與取得勾選列資料的完整做法
編輯:JavaScript綜合知識     

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 清單。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved