萬盛學電腦網

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

JavaScript 實現表格合併相同內容單元格完整算法

前言

報表展示中,連續行相同列值合併(rowSpan)能大幅提升可讀性。本文實現一個通用的表格合併函數,支援多列合併、顏色區分、動態數據綁定。

核心合併算法

function mergeTableCells(tableId, colsToMerge) {
    var table = document.getElementById(tableId);
    if (!table) return;
    
    // colsToMerge: 要合併的列索引數組,如 [0, 1, 2] 表示前三列
    // 從最後一列向前處理,避免 rowSpan 影響後續列索引
    for (var c = colsToMerge.length - 1; c >= 0; c--) {
        var colIdx = colsToMerge[c];
        var rowSpan = 1;
        var startRow = 0;
        var prevValue = null;
        var altColor = false;
        
        for (var r = 0; r < table.rows.length; r++) {
            var cell = table.rows[r].cells[colIdx];
            if (!cell) continue;
            
            var currValue = cell.innerText.trim();
            
            if (currValue === prevValue && currValue !== '') {
                // 相同值:增加 rowSpan,隱藏當前單元格
                rowSpan++;
                cell.style.display = 'none';
                // 或者移除:cell.parentNode.removeChild(cell); // 注意:會改變 cells 集合索引
            } else {
                // 不同值:設置前一組的 rowSpan
                if (rowSpan > 1) {
                    var startCell = table.rows[startRow].cells[colIdx];
                    startCell.rowSpan = rowSpan;
                    // 交替顏色區分組
                    if (altColor) {
                        startCell.style.backgroundColor = '#f0f8ff';
                    }
                    altColor = !altColor;
                }
                // 重置計數器
                prevValue = currValue;
                startRow = r;
                rowSpan = 1;
            }
        }
        
        // 處理最後一組
        if (rowSpan > 1) {
            var startCell = table.rows[startRow].cells[colIdx];
            startCell.rowSpan = rowSpan;
            if (altColor) startCell.style.backgroundColor = '#f0f8ff';
        }
    }
}

// 使用:合併第 1、2、3 列(索引 0,1,2)
mergeTableCells('dataTable', [0, 1, 2]);

完整 HTML Demo

<table id="dataTable" border="1" cellpadding="5" cellspacing="0" style="border-collapse:collapse;">
    <thead>
        <tr><th>部門</th><th>組別</th><th>項目</th><th>金額</th></tr>
    </thead>
    <tbody>
        <tr><td>技術部</td><td>前端組</td><td>官網重構</td><td>50萬</td></tr>
        <tr><td>技術部</td><td>前端組</td><td>小程序</td><td>30萬</td></tr>
        <tr><td>技術部</td><td>後端組</td><td>API網關</td><td>80萬</td></tr>
        <tr><td>市場部</td><td>品牌組</td><td>雙十一</td><td>120萬</td></tr>
        <tr><td>市場部</td><td>品牌組</td><td>618大促</td><td>90萬</td></tr>
    </tbody>
</table>

<script>mergeTableCells('dataTable', [0, 1]);</script>

算法關鍵點解析

  1. 逆序列處理:從右向左合併,避免左側列 rowSpan 導致右側列 cells 索引錯位。
  2. display: none vs removeChild:display: none 保持 DOM 結構不變,cells 索引穩定;removeChild 會導致後續單元格索引前移,需謹慎處理。
  3. 空值不合併:currValue !== '' 防止空單元格誤合併。
  4. 交替背景色:altColor 變量實現分組視覺區分。

jQuery 版本(簡潔風格)

$.fn.mergeCells = function(cols) {
    return this.each(function() {
        var $table = $(this);
        cols = cols || [0]; // 默認第一列
        
        for (var ci = cols.length - 1; ci >= 0; ci--) {
            var col = cols[ci];
            var $prevTd = null;
            var count = 1;
            
            $table.find('tr').each(function() {
                var $td = $(this).find('td').eq(col);
                if ($td.length === 0) return;
                
                var text = $td.text().trim();
                var prevText = $prevTd ? $prevTd.text().trim() : null;
                
                if (text === prevText && text !== '') {
                    count++;
                    $td.hide(); // 或 remove()
                } else {
                    if (count > 1 && $prevTd) {
                        $prevTd.attr('rowspan', count);
                        $prevTd.css('background', count % 2 === 0 ? '#f0f8ff' : '');
                    }
                    $prevTd = $td;
                    count = 1;
                }
            });
            
            // 最後一組
            if (count > 1 && $prevTd) {
                $prevTd.attr('rowspan', count);
            }
        }
    });
};

// 使用
$('#dataTable').mergeCells([0, 1]);

動態數據綁定場景

// AJAX 獲取數據後渲染表格,再調用合併
$.getJSON('/api/report', function(data) {
    renderTable(data); // 渲染完整表格
    mergeTableCells('dataTable', [0, 1]); // 合併
});

// 或在模板引擎渲染時直接輸出 rowSpan(服務端合併,性能更優)

注意事項

  • rowSpan 跨行時,被隱藏的行對應列單元格必須移除或隱藏,否則布局錯亂。
  • thead 內單元格不參與合併(示例從 tbody 開始)。
  • 合併後若需導出 Excel,需同步生成合併區域配置(如 NPOI/EPPlus sheet.AddMergedRegion)。
  • 大數據量(>1000 行)建議服務端合併或虛擬滾動表格組件。

總結

表格合併核心邏輯:逆序遍歷列 → 正序遍歷行 → 比較相鄰值 → 累計 rowSpan → 隱藏重複單元格。原生 JS 版零依賴、效能高;jQuery 版語法糖豐富。實際項目中,服務端渲染時直接輸出 rowSpan 是性能最優、邏輯最清晰的方案;前端合併適用於純前端渲染、用戶動態篩選後的二次合併場景。

copyright © 萬盛學電腦網 all rights reserved