概述
本 Demo 展示了 BYCOL 函数的基本用法，演示如何使用 LAMBDA 函数按列处理数组数据。Demo 包含两个示例：返回每列的最大值和返回每列的平方和。
实现思路
初始化工作簿并启用动态数组功能（allowDynamicArray = true）
加载预设的表格数据（数据值、公式和样式）
示例 1：使用 BYCOL 结合 MAX 函数计算每列的最大值
示例 2：使用 BYCOL 结合 SUMSQ 函数计算每列的平方和
使用 FORMULATEXT 函数在结果旁边显示公式文本
代码解析
启用动态数组功能
在使用 BYCOL 函数之前，需要先启用动态数组选项。BYCOL 属于动态数组函数，会返回溢出结果。
示例 1：返回每列的最大值
BYCOL 函数接收两个参数：array 是要处理的数组区域，lambda 是应用于每列的 LAMBDA 函数。LAMBDA 函数接收一个参数 array（代表单列数据），返回该列的计算结果。
示例 2：返回每列的平方和
这个示例展示了如何在 LAMBDA 函数中使用其他 Excel 函数。SUMSQ 函数计算每个列中所有元素的平方和。
显示公式文本
使用 FORMULATEXT 函数在结果旁边显示公式文本，方便用户查看和理解使用的公式。
运行效果
表格中显示两组示例数据，每组包含 3 列 2 行的数据区域
示例 1 的结果区域显示每列的最大值：4、5、6
示例 2 的结果区域显示每列的平方和：17、29、45
每个示例旁边都显示使用的公式文本，便于学习理解
所有结果通过 BYCOL 函数自动计算并显示
API 参考
BYCOL 函数语法
array：要用列来分隔的数组
lambda：一个 LAMBDA 函数，将一个列作为单一参数，并计算一个结果
column：数组中的一个列
BYCOL 函数将 LAMBDA 应用于数组的每一列，返回结果组成的数组。如果原始数组是 3 列 2 行，返回的数组是 3 列 1 行。
var data = {
values: {
1: { 1: "示例" },
3: { 1: "示例 1: 返回每列的最大值" },
4: { 1: "数据:", 5: "公式:" },
5: { 1: 1, 2: 2, 3: 3, 5: "结果:" },
6: { 1: 4, 2: 5, 3: 6 },
8: { 1: "示例 2: 返回每列中每个数组元素的平方和" },
9: { 1: "数据:", 5: "公式:" },
10: { 1: 1, 2: 2, 3: 3, 5: "结果:" },
11: { 1: 4, 2: 5, 3: 6 },
},
formulas: {
4: { 6: "FORMULATEXT(G6)" },
5: { 6: "BYCOL(B6:D7,LAMBDA(array,MAX(array)))" },
9: { 6: "FORMULATEXT(G11)" },
10: { 6: "BYCOL(B11:D12,LAMBDA(array,SUMSQ(array)))" },
},
cellStyles: {
"B2:C2": 0,
"B4:G4": 1,
B5: 2,
C5: 3,
D5: 4,
F5: 5,
"G5:I6": 6,
"J5:K5": 6,
"B6:D7": 7,
F6: 8,
"B9:J9": 1,
B10: 2,
C10: 3,
D10: 4,
F10: 5,
"G10:I11": 6,
"J10:K10": 6,
"B11:D12": 7,
F11: 8,
},
styles: {
records: [
{ foreColor: 0, font: 0, border: [null, null, 0] },
{ foreColor: 0, font: 1, border: [null, null, 1] },
{ backColor: 2, foreColor: 1, font: 1, border: [null, null, 2, 3] },
{ backColor: 2, foreColor: 1, font: 1, border: [4, null, 2] },
{ backColor: 2, foreColor: 1, font: 1, border: [4, 3, 2] },
{ backColor: 2, foreColor: 1, font: 1, border: [3, 2, 3, 3] },
{ backColor: 4, foreColor: 3, font: 1, border: [2, 2, 2, 2] },
{ backColor: 6, foreColor: 5, border: [2, 2, 2, 2] },
{ backColor: 2, foreColor: 1, font: 1, border: [3, 3, 3, 3] },
],
borders: [
{ color: "#accdea", style: 5 },
{ color: "#9bc3e6", style: 2 },
{ color: "#7f7f7f", style: 1 },
{ color: "#9bc3e6", style: 1 },
{ color: "#000000", style: 1 },
],
colors: ["#44546a", "#ffffff", "#5b9bd5", "#fa7d00", "#f2f2f2", "#3f3f76", "#ffcc99"],
fonts: ["700 17.3px Calibri", "700 14.7px Calibri"],
},
others: {
columnWidth: { 0: 30 },
rowHeight: { 1: 24, 2: 21, 3: 21, 8: 21 },
spans: ["B5:D5", "B10:D10"],
},
};
window.onload = function () {
var workbook = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
workbook.options.allowDynamicArray = true;
workbook.suspendPaint();
initSheet1(workbook.getSheet(0));
workbook.resumePaint();
};
function initSheet1(sheet) {
setSheetPr(sheet);
setCells(sheet);
}
function setCells(sheet) {
foreachObj(data.values, function (r, row) {
foreachObj(row, function (c, v) {
setValue(sheet, Number(r), Number(c), v);
});
});
foreachObj(data.formulas, function (r, row) {
foreachObj(row, function (c, v) {
setFormula(sheet, Number(r), Number(c), v);
});
});
foreachObj(data.cellStyles, function (ref, id) {
setStyle(sheet, ref, data.styles.records[id]);
});
}
function setValue(sheet, r, c, v) {
if (v === undefined || v === null) return;
sheet.setValue(r, c, v);
}
function setFormula(sheet, r, c, v) {
if (v === undefined || v === null) return;
sheet.setFormula(r, c, v);
}
function setStyle(sheet, ref, v) {
if (v === undefined || v === null) return;
var styles = data.styles;
var range = sheet.getRange(ref);
var foreColor = styles.colors[v.foreColor];
var backColor = styles.colors[v.backColor];
var font = styles.fonts[v.font];
var wordWrap = v.wordWrap;
if (foreColor) {
range.foreColor(foreColor);
}
if (backColor) {
range.backColor(backColor);
}
if (font) {
range.font(font);
}
if (wordWrap) {
range.wordWrap(wordWrap);
}
var border = v.border || [];
var borderTop = styles.borders[border[0]];
var borderRight = styles.borders[border[1]];
var borderBottom = styles.borders[border[2]];
var borderLeft = styles.borders[border[3]];
if (borderTop) {
range.borderTop(createLineStyle(borderTop));
}
if (borderBottom) {
range.borderBottom(createLineStyle(borderBottom));
}
if (borderLeft) {
range.borderLeft(createLineStyle(borderLeft));
}
if (borderRight) {
range.borderRight(createLineStyle(borderRight));
}
}
function setSheetPr(sheet) {
// set column width
foreachObj(data.others.columnWidth, function (index, v) {
sheet.setColumnWidth(Number(index), v);
});
// set row height
foreachObj(data.others.rowHeight, function (index, v) {
sheet.setRowHeight(Number(index), v);
});
// set spans
var spans = data.others.spans || [];
for (var i = 0; i < spans.length; i++) {
var range = sheet.getRange(spans[i]);
sheet.addSpan(range.row, range.col, range.rowCount, range.colCount);
}
}
function createLineStyle(v) {
return new GC.Spread.Sheets.LineBorder(v.color, v.style);
}
function foreachObj(obj, func) {
if (!obj) return;
var keys = Object.keys(obj);
for (var i = 0; i < keys.length; i++) {
var key = keys[i];
var v = obj[key];
func(key, v);
}
}
<!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/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;
}
