在數據量大的表格中,固定表頭能極大提升用戶體驗。本文提供一個基於 jQuery 的完整解決方案,通過克隆原表格的 `` 並定位在滾動容器上方,實現表頭固定、列寬自適應、兼容滾動條寬度等功能。
這個方案純前端實現,無需修改後端代碼,兼容性良好(IE8+、現代瀏覽器)。核心思想是「克隆 + 定位 + 寬度同步」,理解原理後可輕鬆擴展為支持固定列、多級表頭等復雜場景。一、核心 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>
三、關鍵技術點解析
四、常見問題與優化
五、結語
JavaScript排行
推薦文章