概述
本 Demo 展示了如何使用自动合并功能将具有相同内容的相邻单元格自动合并。Demo 以一个电视节目时间表为例，通过下拉框动态切换不同的合并方向，展示各种合并效果。
实现思路
初始化工作表，设置行列数、表头和默认样式
使用 setArray 方法填充电视节目时间表数据
调用 autoMerge 方法对整个工作表应用自动合并（初始为 columnRow 方向）
为下拉框添加事件监听器，动态切换合并方向
切换时先取消旧的自动合并（direction 设为 none），再应用新的合并方向
代码解析
初始化工作表和数据
这段代码设置了列表头（星期）和行表头（时间段），然后使用 setArray 一次性填充所有节目数据。
应用自动合并
Range(-1, -1, -1, -1) 表示整个工作表区域。AutoMergeDirection.columnRow 表示优先在列方向合并，再在行方向合并。这样，连续相同的节目名称会在列方向优先合并。
动态切换合并方向
切换合并方向时，先将 direction 设为 none 取消原有的自动合并，然后根据下拉框的值应用新的合并方向。使用 suspendPaint 和 resumePaint 可以提升性能，避免多次重绘。
运行效果
表格加载后，具有相同内容的相邻单元格会自动合并显示（默认为列行方向）
通过下拉框可以切换 5 种合并模式：无、列、行、列行、行列
选择"列"时，只在垂直方向合并相同内容的单元格
选择"行"时，只在水平方向合并相同内容的单元格
选择"列行"时，优先在列方向合并，再在行方向合并
选择"行列"时，优先在行方向合并，再在列方向合并
API 参考
autoMerge 方法
range：要应用自动合并的范围，类型为 GC.Spread.Sheets.Range
direction：自动合并的方向，可选值：
AutoMergeDirection.none：取消自动合并
AutoMergeDirection.column：按列方向合并
AutoMergeDirection.row：按行方向合并
AutoMergeDirection.columnRow：先按列方向合并，再按行方向合并
AutoMergeDirection.rowColumn：先按行方向合并，再按列方向合并
mode：自动合并模式，可选值：AutoMergeMode.free（默认，自由合并）或 AutoMergeMode.restricted（受限合并）
sheetArea：工作表区域，默认为 SheetArea.viewport
selectionMode：选择模式，可选值：SelectionMode.source（选择单个单元格）或 SelectionMode.merged（选择整个合并单元格）
AutoMergeDirection 枚举
表示自动合并的方向：
none (0)：无
column (1)：按列
row (2)：按行
columnRow (3)：先列后行
rowColumn (4)：先行后列
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 1 });
initSpread(spread);
};
function initSpread(spread) {
var switchAutoMergeDirection = _getElementById("switchAutoMergeDirection");
switchAutoMergeDirection.addEventListener("change", function (event) {
var range = new GC.Spread.Sheets.Range(-1, -1, -1, -1);
var sheet = spread.getActiveSheet();
sheet.suspendPaint();
//remove old auto merge range
sheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.none);
//add new auto merge range
sheet.autoMerge(range, parseInt(event.target.value));
sheet.resumePaint();
});
spread.suspendPaint();
spread.options.showVerticalScrollbar = false;
spread.options.showHorizontalScrollbar = false;
spread.options.tabStripVisible = false;
//init sheet
var sheet = spread.getActiveSheet();
sheet.defaults.rowHeight = 40;
sheet.defaults.colWidth = 100;
sheet.defaults.colHeaderRowHeight = 40;
sheet.defaults.rowHeaderColWidth = 60;
sheet.setRowCount(5);
sheet.setColumnCount(7);
var defaultStyle = sheet.getDefaultStyle();
defaultStyle.vAlign = GC.Spread.Sheets.VerticalAlign.center;
defaultStyle.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
sheet.setDefaultStyle(defaultStyle);
["周一", "周二", "周三", "周四", "周五", "周六", "周日"].forEach(function (value, index) {
sheet.setValue(0, index, value, GC.Spread.Sheets.SheetArea.colHeader);
});
["12:00", "13:00", "14:00", "15:00", "16:00"].forEach(function (value, index) {
sheet.setValue(index, 0, value, GC.Spread.Sheets.SheetArea.rowHeader);
});
sheet.setArray(0, 0, [
["步行者", "早间节目", "早间节目", "体育", "天气", "无", "无"],
["今日秀", "今日秀", "芝麻街", "足球", "市场观察", "无", "无"],
["今日秀", "今日秀", "儿童天地", "足球", "肥皂剧", "无", "无"],
["新闻", "新闻", "新闻", "新闻", "新闻", "无", "无"],
["新闻", "新闻", "新闻", "新闻", "新闻", "无", "无"]
]);
//apply auto merge
var range = new GC.Spread.Sheets.Range(-1, -1, -1, -1);
sheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.columnRow);
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 class="options-container">
<div class="option-row">
修改自动合并方向。
<select id="switchAutoMergeDirection">
<option value="0">无</option>
<option value="1">列</option>
<option value="2">行</option>
<option value="3" selected="selected">列行</option>
<option value="4">行列</option>
</select>
</div>
</div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
.option-row {
font-size: 14px;
padding: 5px;
margin-top: 10px;
}
#switchAutoMergeDirection {
margin: 10px 0px;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
