概述
本 Demo 展示了如何对列标题和行标题区域应用自动合并功能。Demo 创建了一个包含年份和季度维度的列标题、组别和公司维度的行标题的数据表格，通过自动合并使相同的标题单元格合并显示，提升表格的可读性。
实现思路
创建工作簿和工作表，设置工作表的行列数和默认尺寸
配置列标题区域为 2 行，行标题区域为 2 列
填充列标题数据（年份和季度）和行标题数据（组别和公司）
填充数据区域的随机数据
对列标题区域应用按行方向的自动合并，使相同年份的单元格合并
对行标题区域应用按列方向的自动合并，使相同组别的单元格合并
代码解析
设置标题区域的行列数
通过 setRowCount 和 setColumnCount 方法的第二个参数指定操作的区域为列标题或行标题。
填充列标题数据
使用 setValue 方法的第四个参数指定填充到列标题区域。
填充行标题数据
使用 setValue 方法的第四个参数指定填充到行标题区域。
对标题区域应用自动合并
autoMerge 方法的关键参数：
range：使用 Range(-1, -1, -1, -1) 表示整个区域
direction：row 表示按行方向合并（列标题中相同值横向合并），column 表示按列方向合并（行标题中相同值纵向合并）
mode：free 表示自由模式，相邻相同值即可合并
sheetArea：colHeader 指定列标题区域，rowHeader 指定行标题区域
运行效果
列标题区域的第一行中，相同的年份（2018 和 2019）会自动横向合并显示
行标题区域的第一列中，相同的组别（Group1、Group2 等）会自动纵向合并显示
数据区域显示随机生成的数值
合并效果在渲染时自动完成，无需手动创建合并单元格
API 参考
autoMerge 方法
参数说明：
range：要应用自动合并的范围，类型为 Range
direction：自动合并的方向，可选值为 row（按行）、column（按列）、rowColumn、columnRow、none（取消合并），默认为 column
mode：自动合并的模式，free（自由模式）或 restricted（受限模式），默认为 free
sheetArea：工作表区域，可选值为 viewport（数据区域）、colHeader（列标题）、rowHeader（行标题）、corner（角落），默认为 viewport
selectionMode：选择模式，source 或 merged，默认为 source
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 1 });
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
var sheet = spread.getActiveSheet();
sheet.setRowCount(10);
sheet.setColumnCount(8);
sheet.defaults.rowHeight = 40;
sheet.defaults.colWidth = 100;
sheet.defaults.colHeaderRowHeight = 40;
sheet.defaults.rowHeaderColWidth = 100;
sheet.setRowCount(2, GC.Spread.Sheets.SheetArea.colHeader);
sheet.setColumnCount(2, GC.Spread.Sheets.SheetArea.rowHeader);
[2018, 2018, 2018, 2018, 2019, 2019, 2019, 2019].forEach(function (value, index) {
sheet.setValue(0, index, value, GC.Spread.Sheets.SheetArea.colHeader);
});
["Q1", "Q2", "Q3", "Q4","Q1", "Q2", "Q3", "Q4"].forEach(function (value, index) {
sheet.setValue(1, index, value, GC.Spread.Sheets.SheetArea.colHeader);
});
["Group1", "Group1", "Group1", "Group1","Group2", "Group2", "Group2", "Group3", "Group3", "Group4"].forEach(function (value, index) {
sheet.setValue(index, 0, value, GC.Spread.Sheets.SheetArea.rowHeader);
});
["Company1", "Company2", "Company3", "Company4","Company5", "Company6", "Company7", "Company8", "Company9", "Company10"].forEach(function (value, index) {
sheet.setValue(index, 1, value, GC.Spread.Sheets.SheetArea.rowHeader);
});
for (var r = 0; r < 10; r++) {
for (var c = 0; c < 8; c++) {
sheet.setValue(r, c, Math.round(Math.random() * 10000));
}
}
//apply auto merge
var range = new GC.Spread.Sheets.Range(-1, -1, -1, -1);
sheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.row, GC.Spread.Sheets.AutoMerge.AutoMergeMode.free, GC.Spread.Sheets.SheetArea.colHeader);
sheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.column, GC.Spread.Sheets.AutoMerge.AutoMergeMode.free, GC.Spread.Sheets.SheetArea.rowHeader);
spread.resumePaint();
}
function _getElementById(id) {
return document.getElementById(id);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/data/data.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-spreadsheets"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: 100%;
height: 100%;
overflow: hidden;
float: left;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
