DIV CSS 佈局教程網

flexigrid 表格元件參數完整說明
編輯:關於JavaScript     

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);

使用時幾個實務重點:

  • dataType 與後端格式必須對齊。元件預設吃 XML,若後端回 JSON 就要相對調整解析方式,這是最常出錯的地方。
  • 分頁三個參數要一起設定。usepager 開啟後,page 與 total 通常應由後端回應帶回,而不是寫死在前端。
  • query 與 qtype 是搭配後端搜尋用的,元件會把它們併入 AJAX 請求參數,後端需自行處理。
  • showToggleBtn 已知有 bug,設為 false 時點擊表頭會報錯,需要的話得自行修改原始碼。
  • 三個回呼(onSubmit、onSuccess、onChangeSort)是客製化的主要入口,例如要在送出前補上額外查詢條件,就掛在 onSubmit。

要提醒的是,flexigrid 早已停止維護。新專案若需要具備排序、分頁、欄位凍結與大量資料虛擬滾動的表格,建議改用 DataTables、AG Grid、TanStack Table 這類仍在持續更新的方案。

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