做後台報表時常會碰到這樣的需求:資料多到必須捲動,但使用者希望表頭永遠留在視線內,前幾個關鍵欄位(例如品名、編號)也不要被捲走。這種「凍結窗格」在 Excel 裡很常見,在網頁上卻得自己動手做。本文把當時的實作思路完整整理出來,讓你可以自由指定要凍結幾列、幾欄。
整個做法其實不複雜,關鍵是「複製表格 + 層級堆疊」:
position:absolute 與 z-index 把它疊在資料層上方。接著只要監聽資料層的捲動事件,把 scrollLeft 同步給凍結列層、scrollTop 同步給凍結欄層,視覺上就完全黏在一起了。最後再掛上 resize 事件,視窗尺寸變動時重新計算各層寬高。
/* 鎖定表頭與欄位
* table - 要鎖定的表格元素或表格 id
* freezeRowNum - 要鎖定的前幾列列數,不鎖定列則傳 0
* freezeColumnNum - 要鎖定的前幾欄欄數,不鎖定欄則傳 0
* width - 捲動區域寬度
* height - 捲動區域高度
*/
function freezeTable(table, freezeRowNum, freezeColumnNum, width, height) {
if (typeof(freezeRowNum) == 'string') freezeRowNum = parseInt(freezeRowNum)
if (typeof(freezeColumnNum) == 'string') freezeColumnNum = parseInt(freezeColumnNum)
var tableId;
if (typeof(table) == 'string') {
tableId = table;
table = $('#' + tableId);
} else tableId = table.attr('id');
var divTableLayout = $("#" + tableId + "_tableLayout");
if (divTableLayout.length != 0) {
divTableLayout.before(table);
divTableLayout.empty();
} else {
table.after("<div id='" + tableId + "_tableLayout' style='overflow:hidden;height:" + height + "px; width:" + width + "px;'></div>");
divTableLayout = $("#" + tableId + "_tableLayout");
}
var html = '';
if (freezeRowNum > 0 && freezeColumnNum > 0) html += '<div id="' + tableId + '_tableFix" style="padding: 0px;"></div>';
if (freezeRowNum > 0) html += '<div id="' + tableId + '_tableHead" style="padding: 0px;"></div>';
if (freezeColumnNum > 0) html += '<div id="' + tableId + '_tableColumn" style="padding: 0px;"></div>';
html += '<div id="' + tableId + '_tableData" style="padding: 0px;"></div>';
$(html).appendTo("#" + tableId + "_tableLayout");
var divTableFix = freezeRowNum > 0 && freezeColumnNum > 0 ? $("#" + tableId + "_tableFix") : null;
var divTableHead = freezeRowNum > 0 ? $("#" + tableId + "_tableHead") : null;
var divTableColumn = freezeColumnNum > 0 ? $("#" + tableId + "_tableColumn") : null;
var divTableData = $("#" + tableId + "_tableData");
divTableData.append(table);
if (divTableFix != null) {
var tableFixClone = table.clone(true);
tableFixClone.attr("id", tableId + "_tableFixClone");
divTableFix.append(tableFixClone);
}
if (divTableHead != null) {
var tableHeadClone = table.clone(true);
tableHeadClone.attr("id", tableId + "_tableHeadClone");
divTableHead.append(tableHeadClone);
}
if (divTableColumn != null) {
var tableColumnClone = table.clone(true);
tableColumnClone.attr("id", tableId + "_tableColumnClone");
divTableColumn.append(tableColumnClone);
}
$("#" + tableId + "_tableLayout table").css("margin", "0");
// 計算凍結列的總高度,需把 rowspan 造成的額外列排除
if (freezeRowNum > 0) {
var HeadHeight = 0, ignoreRowNum = 0;
$("#" + tableId + "_tableHead tr:lt(" + freezeRowNum + ")").each(function () {
if (ignoreRowNum > 0) ignoreRowNum--;
else {
var td = $(this).find('td:first, th:first');
HeadHeight += td.outerHeight(true);
ignoreRowNum = td.attr('rowSpan');
if (typeof(ignoreRowNum) == 'undefined') ignoreRowNum = 0;
else ignoreRowNum = parseInt(ignoreRowNum) - 1;
}
});
HeadHeight += 2;
divTableHead.css("height", HeadHeight);
divTableFix != null && divTableFix.css("height", HeadHeight);
}
// 計算凍結欄的總寬度,同樣要處理 colspan
if (freezeColumnNum > 0) {
var ColumnsWidth = 0, ColumnsNumber = 0;
$("#" + tableId + "_tableColumn tr:eq(" + freezeRowNum + ")")
.find("td:lt(" + freezeColumnNum + "), th:lt(" + freezeColumnNum + ")").each(function () {
if (ColumnsNumber >= freezeColumnNum) return;
ColumnsWidth += $(this).outerWidth(true);
ColumnsNumber += $(this).attr('colSpan') ? parseInt($(this).attr('colSpan')) : 1;
});
ColumnsWidth += 2;
divTableColumn.css("width", ColumnsWidth);
divTableFix != null && divTableFix.css("width", ColumnsWidth);
}
// 捲動同步
divTableData.scroll(function () {
divTableHead != null && divTableHead.scrollLeft(divTableData.scrollLeft());
divTableColumn != null && divTableColumn.scrollTop(divTableData.scrollTop());
});
divTableFix != null && divTableFix.css({ "overflow": "hidden", "position": "absolute", "z-index": "50" });
divTableHead != null && divTableHead.css({ "overflow": "hidden", "width": width - 17, "position": "absolute", "z-index": "45" });
divTableColumn != null && divTableColumn.css({ "overflow": "hidden", "height": height - 17, "position": "absolute", "z-index": "40" });
divTableData.css({ "overflow": "scroll", "width": width, "height": height, "position": "absolute" });
divTableFix != null && divTableFix.offset(divTableLayout.offset());
divTableHead != null && divTableHead.offset(divTableLayout.offset());
divTableColumn != null && divTableColumn.offset(divTableLayout.offset());
divTableData.offset(divTableLayout.offset());
}
/* resize 事件中呼叫,重新設定各層尺寸 */
function adjustTableSize(table, width, height) {
var tableId = (typeof(table) == 'string') ? table : table.attr('id');
$("#" + tableId + "_tableLayout").width(width).height(height);
$("#" + tableId + "_tableHead").width(width - 17);
$("#" + tableId + "_tableColumn").height(height - 17);
$("#" + tableId + "_tableData").width(width).height(height);
}
function pageHeight() {
if ($.browser.msie) {
return document.compatMode == "CSS1Compat" ? document.documentElement.clientHeight : document.body.clientHeight;
} else { return self.innerHeight; }
}
function pageWidth() {
if ($.browser.msie) {
return document.compatMode == "CSS1Compat" ? document.documentElement.clientWidth : document.body.clientWidth;
} else { return self.innerWidth; }
}
$(document).ready(function () {
var table = $("table");
var tableId = table.attr('id');
var freezeRowNum = table.attr('freezeRowNum');
var freezeColumnNum = table.attr('freezeColumnNum');
if (typeof(freezeRowNum) != 'undefined' || typeof(freezeColumnNum) != 'undefined') {
freezeTable(table, freezeRowNum || 0, freezeColumnNum || 0, pageWidth(), pageHeight());
var flag = false;
$(window).resize(function () {
if (flag) return;
setTimeout(function () {
adjustTableSize(tableId, pageWidth(), pageHeight());
flag = false;
}, 100);
flag = true;
});
}
});
使用方式非常直覺,只要在 table 標籤上加兩個自訂屬性即可:
<table id="reportTable" width="1900" freezeRowNum="2" freezeColumnNum="2" class="report" align="center">
...
</table>
這段程式碼是以 jQuery 1.x 時代的 API 撰寫的(例如 $.browser),在新版 jQuery 或現代瀏覽器上需要改用特性偵測與 position:sticky 這類原生方案。若只是維護舊專案,直接沿用即可;若是新專案,建議優先評估 CSS position:sticky 搭配 border-collapse:separate 的寫法,能省下大量 DOM 複製的開銷。