DIV CSS 佈局教程網

用 jQuery 凍結表格的表頭與欄位:可任意指定列數的完整做法
編輯:JavaScript綜合知識     

做後台報表時常會碰到這樣的需求:資料多到必須捲動,但使用者希望表頭永遠留在視線內,前幾個關鍵欄位(例如品名、編號)也不要被捲走。這種「凍結窗格」在 Excel 裡很常見,在網頁上卻得自己動手做。本文把當時的實作思路完整整理出來,讓你可以自由指定要凍結幾列、幾欄。

核心原理:用多層 div 疊出凍結效果

整個做法其實不複雜,關鍵是「複製表格 + 層級堆疊」:

  • 建立一個外層容器 div 作為可捲動的視窗,內部再放幾層子 div。
  • 需要凍結列時,把原表格複製一份放進「凍結列層」,用 position:absolute 與 z-index 把它疊在資料層上方。
  • 需要凍結欄時同理,再複製一份放進「凍結欄層」。
  • 若要同時凍結列與欄,還要多一層「左上角」的 div,只顯示凍結列與凍結欄的交集,並放在最上層。

接著只要監聽資料層的捲動事件,把 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 複製的開銷。

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