萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現表格表頭固定滾動效果完整實例

項目背景

在數據量大的表格中,固定表頭能極大提升用戶體驗。本文提供一個基於 jQuery 的完整解決方案,通過克隆原表格的 `` 並定位在滾動容器上方,實現表頭固定、列寬自適應、兼容滾動條寬度等功能。

一、核心 JavaScript 文件:jQuery_FixedTableHead.js

/**
 * 表格表頭固定插件
 * @param {string} tableId - 原表格 ID
 * @param {string} tableParentDivId - 包裹表格的滾動容器 ID
 */
jQuery.fn.CloneTableHeader = function(tableId, tableParentDivId) {
  // 1. 清理舊的克隆表頭
  var oldHeader = document.getElementById('tableHeaderDiv' + tableId);
  if (oldHeader) {
    jQuery(oldHeader).remove();
  }

  // 2. 獲取滾動容器與原表格
  var $container = jQuery('#' + tableParentDivId);
  var $tableOrg = jQuery('#' + tableId);
  
  // 計算滾動條寬度(用於最後一列寬度補償)
  var scrollWidth = $container[0].offsetWidth - $container[0].clientWidth;

  // 3. 克隆整個表格,僅保留 thead
  var $tableClone = $tableOrg.clone();
  $tableClone.attr('id', 'cloneTable');
  
  var $thead = $tableOrg.find('thead');
  var theadHeight = $thead.height();
  $thead.hide(); // 隱藏原表頭

  // 4. 獲取 tbody 第一行 td 的寬度(作為列寬基準)
  var colWidths = $tableOrg.find('tbody tr:first td').map(function() {
    return jQuery(this).width();
  }).get(); // 轉為原生數組

  // 5. 設置克隆表頭每列寬度
  var $cloneThs = $tableClone.find('thead tr:first th, thead tr:first td');
  if (colWidths.length > 0) {
    $cloneThs.each(function(i) {
      var w = colWidths[i];
      // 最後一列補償滾動條寬度(IE8 特殊處理)
      if (i === colWidths.length - 1) {
        var isIE8 = /*@cc_on!@*/false && document.documentMode === 8;
        w = isIE8 ? w + scrollWidth : w;
      }
      jQuery(this).width(w);
    });
  }

  // 6. 創建固定表頭容器並插入
  var $headerDiv = jQuery('
') .css({ height: theadHeight, overflow: 'hidden', 'z-index': 20, width: '100%', position: 'absolute', top: 0, left: 0 }) .append($tableClone) .prependTo($container.parent()); // 插入到容器之前 // 7. 同步水平滾動(可選增強) $container.on('scroll', function() { $headerDiv.scrollLeft($(this).scrollLeft()); }); };

二、HTML 完整示例

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta charset="utf-8" />
<title>jQuery 表格固定表頭演示</title>
<script src="https://cdn.jsdelivr.net/npm/jquery@1.12.4/dist/jquery.min.js"></script>
<script src="jQuery_FixedTableHead.js"></script>
<style>
  .scroll-wrap {
    height: 300px;
    overflow: auto;
    border: 1px solid #ccc;
    position: relative; /* 為絕對定位的表頭提供定位上下文 */
  }
  .data-table {
    width: 100%;
    border-collapse: collapse;
    table-layout: fixed; /* 關鍵:固定表格佈局,列寬由首行決定 */
  }
  .data-table th,
  .data-table td {
    border: 1px solid #ddd;
    padding: 8px;
    text-align: center;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
  }
  .data-table thead th {
    background: #f5f5f5;
    font-weight: bold;
  }
</style>
</head>
<body>
<div id="scrollWrap" class="scroll-wrap">
  <table id="dataTable" class="data-table">
    <thead>
      <tr>
        <th>編號</th>
        <th>姓名</th>
        <th>部門</th>
        <th>職位</th>
        <th>薪資</th>
        <th>入職日期</th>
        <th>備註</th>
      </tr>
    </thead>
    <tbody>
      <tr><td>1</td><td>張三</td><td>技術部</td><td>工程師</td><td>12000</td><td>2020-01-15</td><td>表現優異</td></tr>
      <tr><td>2</td><td>李四</td><td>產品部</td><td>經理</td><td>18000</td><td>2018-03-22</td><td>核心骨幹</td></tr>
      <!-- 更多行數據... -->
    </tbody>
  </table>
</div>

<script>
  jQuery(function($) {
    // 初始化固定表頭
    $.fn.CloneTableHeader('dataTable', 'scrollWrap');
  });
</script>
</body>
</html>

三、關鍵技術點解析

  1. table-layout: fixed:強制表格按 `` 或首行單元格寬度佈局,防止內容撐開列寬導致表頭對齊錯位。
  2. 滾動條寬度補償:最後一列加上 `scrollWidth`,避免固定表頭比內容表格窄一個滾動條寬度。
  3. 絕對定位 + 容器 relative:固定表頭容器 `position: absolute; top: 0;`,父容器 `position: relative`,確保表頭始終貼頂。
  4. 水平滾動同步:監聽容器 `scroll` 事件,同步更新固定表頭的 `scrollLeft`,實現左右滾動時表頭跟隨。
  5. 銷毀與重建:調用前先移除舊的克隆節點,支持動態數據更新後重新初始化。

四、常見問題與優化

  • 列寬不一致:確保 `tbody` 至少有一行數據,且單元格無 `colspan`/`rowspan`;若表格初始隱藏,需在顯示後重新調用。
  • 響應式適配:窗口 resize 時重新計算列寬並調用插件,或使用 `th` 寬度百分比配合 `table-layout: fixed`。
  • 性能優化:大數據量時,考慮虛擬滾動或分頁,避免一次性渲染上萬行 DOM。

五、結語

這個方案純前端實現,無需修改後端代碼,兼容性良好(IE8+、現代瀏覽器)。核心思想是「克隆 + 定位 + 寬度同步」,理解原理後可輕鬆擴展為支持固定列、多級表頭等復雜場景。

copyright © 萬盛學電腦網 all rights reserved