DIV CSS 佈局教程網

jqGrid 多選:開啟核取框、取出所選列與程式化選中
編輯:JQuery特效代碼     

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。

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