DIV CSS 佈局教程網

jQuery 凍結表格表頭的完整實作與相容性筆記
編輯:JavaScript綜合知識     

做後台系統時常會遇到長列表:資料多到必須捲動,但使用者往下捲之後就搞不清楚每一欄代表什麼了。這時候把表頭凍結住,讓資料列在其下方自由捲動,是最直接的改善。

網路上找過幾個版本都不太合用,於是就自己寫了一支。目前只處理了表頭凍結、沒有做欄位凍結,所以算是不完整的版本,但一般只需要固定表頭的場景已經夠用。

實作原理

做法並不複雜:把原表格複製一份,只保留 thead 部分,放進一個高度固定、overflow:hidden 的容器裡,插到原表格前方。原表格的表頭隱藏起來,剩下的資料列就能在原本的捲動容器裡跑。關鍵在於「兩個表格的欄寬必須完全一致」,否則上下會對不齊,所以程式會動態量測每一欄的寬度再套回去。

程式碼

// 為 jQuery 擴充一個 CloneTableHeader 方法
jQuery.fn.CloneTableHeader = function (tableId, tableParentDivId) {
  // 取得凍結表頭所在的 DIV,若已存在則先移除,避免重複產生
  var obj = document.getElementById("tableHeaderDiv" + tableId);
  if (obj) { jQuery(obj).remove(); }

  var browserName = navigator.appName;   // 瀏覽器資訊,用於後續區分
  var ver = navigator.appVersion;
  var browserVersion = parseFloat(ver.substring(ver.indexOf("MSIE") + 5, ver.lastIndexOf("Windows")));
  var content = document.getElementById(tableParentDivId);
  var scrollWidth = content.offsetWidth - content.clientWidth;   // 捲軸佔的寬度
  var tableOrg = jQuery("#" + tableId);   // 原表格
  var table = tableOrg.clone();           // 複製一份
  table.attr("id", "cloneTable");

  // 注意:要凍結的表頭必須放在 thead 中
  var tableHeader = jQuery(tableOrg).find("thead");
  var tableHeaderHeight = tableHeader.height();
  tableHeader.hide();

  // 動態取得每一列的實際寬度
  var colsWidths = jQuery(tableOrg).find("tbody tr:first td").map(function () {
    return jQuery(this).width();
  });
  var tableCloneCols = jQuery(table).find("thead tr:first td");

  if (colsWidths.size() > 0) {
    for (i = 0; i < tableCloneCols.size(); i++) {
      if (i == tableCloneCols.size() - 1) {
        // 最後一欄要補上捲軸寬度,IE8 需要額外處理
        if (browserVersion == 8.0) {
          tableCloneCols.eq(i).width(colsWidths[i] + scrollWidth);
        } else {
          tableCloneCols.eq(i).width(colsWidths[i]);
        }
      } else {
        tableCloneCols.eq(i).width(colsWidths[i]);
      }
    }
  }

  // 建立凍結表頭的容器並設定屬性
  var headerDiv = document.createElement("div");
  headerDiv.appendChild(table[0]);
  jQuery(headerDiv).css("height", tableHeaderHeight);
  jQuery(headerDiv).css("overflow", "hidden");
  jQuery(headerDiv).css("z-index", "20");
  jQuery(headerDiv).css("width", "100%");
  jQuery(headerDiv).attr("id", "tableHeaderDiv" + tableId);
  jQuery(headerDiv).insertBefore(tableOrg.parent());
}

呼叫方式

<script type="text/javascript">
jQuery(function () {
  jQuery.fn.CloneTableHeader("tab1", "div1");
});
</script>

只要傳入表格本身的 ID 與它所在容器的 ID 即可。務必注意:要被凍結的表頭一定要放在 thead 裡,否則程式找不到它,凍結自然無效。

實測結果與替代方案

這段程式在 IE6、7、8 上測試通過;Firefox 與 Chrome 則會出現表頭寬度不準的問題,主要是因為不同瀏覽器對 table-layout 與捲軸寬度的計算方式不同。

如果不必支援這麼舊的環境,現在有更省事的做法:用兩個 <table> 搭配 CSS 的 position: sticky 就能讓 thead 自然凍結,程式碼量不到這裡的十分之一;或使用 DataTables 的 FixedColumns/FixedHeader 擴充,連欄位凍結都一起解決。這支手寫版本最大的價值,是作為理解背後原理的教材。

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