萬盛學電腦網

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

jQuery 實現表格表頭固定浮動(原生滾動監聽方案)

場景

長表格滾動時,表頭固定在視口頂部,方便對照列含義。項目已用 jQuery + 純 HTML,需最小改動實現。

HTML 結構(多行表頭)

<table id="dataTable">
  <thead>
    <tr class="header"><td width="150"></td><td colspan="2"></td><td colspan="7">師資力量</td><td colspan="14">科研</td><td></td></tr>
    <tr class="header"><td></td><td colspan="2">人才培養</td><td colspan="3">職稱結構</td>...</tr>
    <tr class="header"><td>教學單位</td><td>本科生數</td>...</tr>
  </thead>
  <tbody>...</tbody>
</table>
<!-- 佔位行,防止浮動表頭遮擋內容 -->
<tr id="hiddenTd"><td colspan="28"></td></tr>

jQuery 實現

$(window).scroll(function() {
    var $headers = $('.header');          // 3 行表頭
    var scrollTop = $(this).scrollTop();  // 文檔滾動距離
    var headerOffset = 55;                // 表頭距離頁面頂部的初始偏移(需根據實際布局測量)

    if (scrollTop > headerOffset) {
        var fixedTop = scrollTop - headerOffset;

        // 逐行設置 absolute 定位,模擬 fixed 效果(避免 fixed 脫離表格流導致列寬錯位)
        $headers.eq(0).css({ position: 'absolute', top: fixedTop });
        $headers.eq(1).css({ position: 'absolute', top: fixedTop + $headers.eq(0).outerHeight() });
        $headers.eq(2).css({ position: 'absolute', top: fixedTop + $headers.eq(0).outerHeight() + $headers.eq(1).outerHeight() });

        // 佔位行高度 = 表頭總高,撐開空間防止內容上移被遮擋
        $('#hiddenTd').height($headers.eq(0).outerHeight() + $headers.eq(1).outerHeight() + $headers.eq(2).outerHeight());
    } else {
        // 滾回頂部區域,恢復靜態定位
        $headers.css({ position: 'static', top: '' });
        $('#hiddenTd').height(0);
    }
});

關鍵技術點

  • absolute 而非 fixed:position:fixed 會使表頭脫離表格流,導致列寬與 tbody 不對齊。absolute 相對最近定位祖先(通常是 table 或包裹 div),保持列寬同步。
  • 多行表頭疊加:第 N 行 top = 固定基準 + 前 N-1 行高度之和。
  • 佔位行:#hiddenTd 高度等於表頭總高,補償 absolute 脫離文檔流導致的內容上移。
  • 禁用 rowspan:多行表頭若用 rowspan,浮動時極易錯位,拆分為多行 colspan 更穩健。

現代優雅方案:CSS position: sticky(推薦新項目)

<style>
#dataTable thead th {
    position: sticky;
    top: 0;
    z-index: 1;
    background: #fff; /* 避免內容滾動時穿透 */
}
</style>
  • 支援:Chrome 56+、Firefox 32+、Safari 6.1+、Edge 16+、**IE 不支援**。
  • 零 JS、零計算、性能最佳、列寬自動對齊。
  • 舊項目兼容 IE 時,用上述 JS 方案作為 Polyfill。

進階:水平滾動同步(固定首列)

// 同理,監聽橫向滾動,固定第一列
$(window).on('scroll', function() {
    var left = $(this).scrollLeft();
    $('#dataTable th:first-child, #dataTable td:first-child').css({ position: 'absolute', left: left });
});

結合垂直 + 水平固定,實現 Excel 風格凍結窗格。

copyright © 萬盛學電腦網 all rights reserved