概述
本 Demo 展示了 SpreadJS 的 11 个数组操作函数，涵盖数组合并、形状转换和大小调整三大类功能。每个函数都通过独立的工作表演示其用法，包括原始数据、公式文本和计算结果。
实现思路
启用动态数组功能（设置 allowDynamicArray 为 true）
为每个数组操作函数创建独立的工作表，工作表名称为函数名
在每个工作表中设置三类内容：Data（原始数据）、Formula（公式文本）、Result（计算结果）
使用自定义函数 setCells 批量设置单元格的值、公式和样式
使用 FORMULATEXT 函数在界面中显示公式文本，方便理解
代码解析
启用动态数组
动态数组功能允许公式返回多个值并自动溢出到相邻单元格。数组操作函数依赖此特性才能正常工作。
批量设置单元格数据
该函数支持三种单元格数据格式：对象格式（包含值 v 和样式 s）、公式字符串（以 = 开头）和普通值。这种设计使得数据配置更加灵活，便于批量设置多个工作表的内容。
数组合并函数
VSTACK 将多个数组垂直堆叠成一个更大的数组，HSTACK 将数组水平堆叠。这些函数适用于合并来自不同区域的数据。
数组形状转换函数
TOROW 和 TOCOL 用于降维操作，将二维数组转换为一维。WRAPROWS 和 WRAPCOLS 则用于升维，按指定宽度或高度将一维数组包裹成二维数组，可以指定填充值。
数组大小调整函数
TAKE 从数组开始或末尾提取指定数量的行或列，DROP 删除指定数量的行或列。CHOOSEROWS 和 CHOOSECOLS 按索引选择特定的行或列，支持重复选择和负数索引。EXPAND 将数组扩展到指定尺寸，可以指定填充值。
运行效果
切换不同工作表查看各个数组操作函数的实际效果
每个工作表分为三部分：Data（原始数据）、Formula（公式文本）、Result（计算结果）
VSTACK 工作表展示垂直堆叠两个数组的结果
HSTACK 工作表展示水平堆叠两个数组的结果
TOROW/TOCOL 工作表展示二维数组降维为一维数组
WRAPROWS/WRAPCOLS 工作表展示一维数组包裹成二维数组
TAKE/DROP 工作表展示从数组提取或删除行/列，支持负数索引从末尾操作
CHOOSEROWS/CHOOSECOLS 工作表展示按索引选择特定行或列
EXPAND 工作表展示数组扩展到指定尺寸
API 参考
allowDynamicArray 选项
启用动态数组功能，允许公式返回多个值并自动溢出到相邻单元格。
setValue 方法
row：行索引
col：列索引
value：要设置的值
sheetArea：可选，指定表单区域
setFormula 方法
row：行索引
col：列索引
formula：公式字符串
sheetArea：可选，指定表单区域
setStyle 方法
row：行索引
col：列索引
style：样式对象
sheetArea：可选，指定表单区域
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(_getElementById("ss"));
spread.options.allowDynamicArray = true;
initStyles(spread);
initSpread(spread);
};
var data = [
{
sheetName: 'VSTACK',
cells: [
[{v:"Data",s:"title"}],
["A","B","C",null,"AA","BB","CC"],
["D","E","F",null,"DD","EE","FF"],
[{v:"Formula",s:"title"}],
["=FORMULATEXT(A7)"],
[{v:"Result",s:"title"}],
["=VSTACK(A2:C3,E2:G3)"]
],
columnsWidth: [69]
},
{
sheetName: 'HSTACK',
cells: [
[{v:"Data",s:"title"}],
["A","B","C",null,"AA","BB","CC"],
["D","E","F",null,"DD","EE","FF"],
[{v:"Formula",s:"title"}],
["=FORMULATEXT(A7)"],
[{v:"Result",s:"title"}],
["=HSTACK(A2:C3,E2:G3)"]
],
columnsWidth: [69]
},
{
sheetName: 'TOROW',
cells: [
[{v:"Data",s:"title"}],
["Ben","Peter","Mary","Sam"],
["John","Hillary","Jenny","James"],
["Agnes","Harry","Felicity","Joe"],
[{v:"Formula",s:"title"}],
["=FORMULATEXT(A8)"],
[{v:"Result",s:"title"}],
["=TOROW(A2:D4)"]
],
columnsWidth: [69]
},
{
sheetName: 'TOCOL',
cells: [
[{v:"Data",s:"title"}],
["Ben","Peter","Mary","Sam"],
["John","Hillary","Jenny","James"],
["Agnes","Harry","Felicity","Joe"],
[{v:"Formula",s:"title"}],
["=FORMULATEXT(A8)"],
[{v:"Result",s:"title"}],
["=TOCOL(A2:D4)"]
],
columnsWidth: [69]
},
{
sheetName: 'WRAPROWS',
cells: [
[{v:"Data",s:"title"}],
["A","B","C","D","E","F","G"],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B5)"],
[{v:"Result",s:"title"}, "=WRAPROWS(A2:G2,3)"],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B10)"],
[{v:"Result",s:"title"}, '=WRAPROWS(A2:G2,3,"x")'],
],
columnsWidth: [69]
},
{
sheetName: 'WRAPCOLS',
cells: [
[{v:"Data",s:"title"}],
["A","B","C","D","E","F","G"],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B5)"],
[{v:"Result",s:"title"}, "=WRAPCOLS(A2:G2,3)"],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B10)"],
[{v:"Result",s:"title"}, '=WRAPCOLS(A2:G2,3,"x")'],
],
columnsWidth: [69]
},
{
sheetName: 'TAKE',
cells: [
[{v:"Data",s:"title"}],
[1,2,3],
[4,5,6],
[7,8,9],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B7)"],
[{v:"Result",s:"title"}, "=TAKE(A2:C4,2)"],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B11)"],
[{v:"Result",s:"title"}, '=TAKE(A2:C4,,2)'],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B16)"],
[{v:"Result",s:"title"}, '=TAKE(A2:C4,-2)'],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B20)"],
[{v:"Result",s:"title"}, '=TAKE(A2:C4,2,2)'],
],
columnsWidth: [69]
},
{
sheetName: 'DROP',
cells: [
[{v:"Data",s:"title"}],
[1,2,3],
[4,5,6],
[7,8,9],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B7)"],
[{v:"Result",s:"title"}, "=DROP(A2:C4,2)"],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B10)"],
[{v:"Result",s:"title"}, '=DROP(A2:C4,,2)'],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B15)"],
[{v:"Result",s:"title"}, '=DROP(A2:C4,-2)'],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B18)"],
[{v:"Result",s:"title"}, '=DROP(A2:C4,2,2)'],
],
columnsWidth: [69]
},
{
sheetName: 'CHOOSEROWS',
cells: [
[{v:"Data",s:"title"}],
[1,2],
[3,4],
[5,6],
[7,8],
[9,10],
[11,12],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B10)"],
[{v:"Result",s:"title"}, "=CHOOSEROWS(A2:B7,1,3,5,1)"],
[],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B16)"],
[{v:"Result",s:"title"}, '=CHOOSEROWS(A2:B7,-1,-2)'],
],
columnsWidth: [69]
},
{
sheetName: 'CHOOSECOLS',
cells: [
[{v:"Data",s:"title"}],
[1,2,3,4,5],
[6,7,8,9,10],
[11,12,13,14,15],
[16,17,18,19,20],
[21,22,23,24,25],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B9)"],
[{v:"Result",s:"title"}, "=CHOOSECOLS(A2:E6,1,3,5,1)"],
[],
[],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B16)"],
[{v:"Result",s:"title"}, '=CHOOSECOLS(A2:E6,-1,-2)'],
],
columnsWidth: [69]
},
{
sheetName: 'EXPAND',
cells: [
[{v:"Data",s:"title"}],
[1,2],
[3,4],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B6)"],
[{v:"Result",s:"title"}, "=EXPAND(A2:B3,3,3)"],
[],
[],
[],
[{v:"Formula",s:"title"}, "=FORMULATEXT(B11)"],
[{v:"Result",s:"title"}, '=EXPAND(A2:B3,3,3, "-")'],
],
columnsWidth: [69]
},
];
function initSpread(workbook) {
workbook.suspendPaint();
workbook.suspendCalcService();
workbook.setSheetCount(data.length);
for (var i = 0; i < data.length; i++) {
var sheetData = data[i];
var sheet = workbook.sheets[i];
sheet.name(sheetData.sheetName);
setCells(sheet, sheetData.cells, 0, 0);
setColumnsWidth(sheet, sheetData.columnsWidth);
}
workbook.resumeCalcService();
workbook.resumePaint();
}
function initStyles(workbook) {
var style = new GC.Spread.Sheets.Style();
style.name = 'title';
style.font = 'normal bold 16px Segoe UI';
style.foreColor = "#172b4d";
workbook.addNamedStyle(style);
}
function setCells(sheet, cells, rowIndex, colIndex) {
for(var i = 0; i < cells.length; i++) {
var row = cells[i];
var r = rowIndex + i;
for (var j = 0; j < row.length; j++) {
var cell = row[j];
var c = colIndex + j;
if (cell === null) {
continue;
}
if (typeof cell === "object") {
if (cell.v !== undefined) {
sheet.setValue(r, c, cell.v);
}
if (cell.s !== undefined) {
sheet.setStyle(r, c, cell.s)
}
} else if (cell[0] === '=') {
sheet.setFormula(r, c, cell);
} else {
sheet.setValue(r, c, cell);
}
}
}
}
function setColumnsWidth(sheet, columnsWidth) {
if (!columnsWidth) {
return;
}
for (var i = 0; i < columnsWidth.length; i++) {
sheet.setColumnWidth(i, columnsWidth[i]);
}
}
function _getElementById(id) {
return document.getElementById(id);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="spreadjs culture" content="zh-cn" />
<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/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>
input[type="text"] {
width: 200px;
margin-right: 20px;
}
label {
display: inline-block;
width: 110px;
}
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: 100%;
height: 100%;
overflow: hidden;
float: left;
}
label {
display: block;
margin-bottom: 6px;
}
input {
padding: 4px 6px;
}
input[type=button] {
margin-top: 6px;
display: block;
width:216px;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
code {
border: 1px solid #000;
}
