報表展示中,連續行相同列值合併(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]);
<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>
rowSpan 導致右側列 cells 索引錯位。display: none 保持 DOM 結構不變,cells 索引穩定;removeChild 會導致後續單元格索引前移,需謹慎處理。currValue !== '' 防止空單元格誤合併。altColor 變量實現分組視覺區分。$.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 開始)。sheet.AddMergedRegion)。表格合併核心邏輯:逆序遍歷列 → 正序遍歷行 → 比較相鄰值 → 累計 rowSpan → 隱藏重複單元格。原生 JS 版零依賴、效能高;jQuery 版語法糖豐富。實際項目中,服務端渲染時直接輸出 rowSpan 是性能最優、邏輯最清晰的方案;前端合併適用於純前端渲染、用戶動態篩選後的二次合併場景。