flexigrid 是早期常見的 jQuery 表格元件,支援 AJAX 分頁、欄寬伸縮、斑馬線與多選。以下把它的設定參數逐項整理,方便對照查閱。
// flexigrid 部分程式碼
if (t.grid) return false; // 若已存在則直接返回
// 套用預設屬性
p = $.extend({
height : 200, // 元件高度,單位 px
width : 'auto', // 寬度,auto 表示依各欄寬度自動計算
striped : true, // 是否顯示斑馬紋(奇偶列交錯)
novstripe : false,
minwidth : 30, // 欄的最小寬度
minheight : 80, // 欄的最小高度
resizable : true, // 是否可伸縮
url : false, // AJAX 方式對應的 url
method : 'POST', // 資料傳送方式
dataType : 'xml', // 資料載入類型
checkbox : false, // 是否顯示多選框
errormsg : '連接錯誤!', // 錯誤提示訊息
usepager : false, // 是否啟用分頁
nowrap : true, // 是否不換行
page : 1, // 預設目前頁
total : 1, // 總頁數
useRp : true, // 是否可動態設定每頁顯示筆數
rp : 15, // 每頁預設筆數
rpOptions : [5, 10, 15, 20, 25, 30, 40], // 可選的每頁筆數
title : false, // 是否包含標題列
pagestat : '顯示第 {from} 條到 {to} 條,共 {total} 條數據', // 頁碼資訊格式
procmsg : '正在處理,請稍候 ...', // 處理中的提示訊息
query : '', // 搜尋查詢條件
qtype : '', // 搜尋查詢類別
nomsg : '沒有數據存在!', // 無結果提示
minColToggle : 1, // 允許顯示的最小欄數
showToggleBtn : true, // 是否允許顯示/隱藏欄位(此屬性有 bug,設為 false 時點擊會報錯)
hideOnSubmit : true, // 隱藏提交
autoload : true, // 自動載入
blockOpacity : 0.5, // 遮罩透明度
onToggleCol : false, // 切換欄位顯示時可覆寫預設行為(實務上鮮少用到)
onChangeSort : false, // 改變排序時可覆寫預設行為,自行實作前端排序
onSuccess : false, // 成功後執行的回呼
onSubmit : false // 提交前執行的回呼
// 呼叫自訂的計算函式
}, p);
使用時幾個實務重點:
usepager 開啟後,page 與 total 通常應由後端回應帶回,而不是寫死在前端。onSubmit、onSuccess、onChangeSort)是客製化的主要入口,例如要在送出前補上額外查詢條件,就掛在 onSubmit。要提醒的是,flexigrid 早已停止維護。新專案若需要具備排序、分頁、欄位凍結與大量資料虛擬滾動的表格,建議改用 DataTables、AG Grid、TanStack Table 這類仍在持續更新的方案。