概述
本 Demo 展示了数组公式的三种典型应用场景:批量计算、数据查找和多条件统计。通过三个工作表分别演示如何使用 setArrayFormula 方法替代多个普通公式,实现更简洁高效的数据处理逻辑。Demo 还实现了数组公式的可视化高亮和公式栏显示功能。
实现思路
初始化工作簿,创建三个工作表分别用于计算、查找和统计场景
为每个工作表设置不同的数据结构和数组公式
绑定 SelectionChanged 事件,当选中数组公式区域时,在公式栏显示公式并用背景色高亮显示
第一个工作表使用数组公式批量计算多行数据的总分
第二个工作表对比数组公式和普通公式的差异,演示数据查找功能
第三个工作表展示多条件逻辑运算(与、或、异或等)
代码解析
批量计算示例
这段代码使用单个数组公式同时计算 6 名学生的总分。公式内部通过 OFFSET 和 ROW 函数动态引用每行的三科成绩区域,SUBTOTAL(9, ...) 计算求和,避免了为每行单独编写公式。
数据查找示例
这个数组公式使用嵌套的 MATCH 和 ISNA 函数进行数组运算,找出 B 列中首个不在 A 列的值。通过数组公式的批量运算能力,可以一次性完成多值比较和查找。
多条件统计示例
数组公式支持在公式中使用数组运算符进行多条件判断。第一个示例使用乘法运算符 * 实现逻辑与(AND),第二个示例使用加法运算符 + 配合 IF 函数实现逻辑或(OR)。
数组公式可视化高亮
当选中数组公式单元格时,Demo 通过 getFormulaInformation 方法获取公式信息,判断是否为数组公式,并为整个公式区域设置背景色(#E0E0FF),同时将公式用大括号 {} 包裹显示在公式栏中。
运行效果
计算工作表:F2-F7 单元格显示每名学生的总分,所有单元格共用一个数组公式,选中任意单元格时整个区域高亮显示
查找工作表:F3 单元格显示数组公式结果(查找差异值),F4 单元格显示普通公式结果,两者结果一致但实现方式不同
统计工作表:演示多种逻辑运算场景,包括逻辑与、逻辑或、逻辑异或等复杂统计
公式栏交互:选中任意数组公式单元格,公式栏会显示用 {} 包裹的公式,整个公式区域背景变为淡蓝色
API 参考
setArrayFormula 方法
row:起始行索引
col:起始列索引
rowCount:公式区域的行数
colCount:公式区域的列数
value:公式字符串(无需包含等号)
sheetArea:可选,指定工作表区域,默认为 viewport
getFormulaInformation 方法
返回包含以下属性的对象:
hasFormula:是否包含公式
isArrayFormula:是否为数组公式
formula:公式字符串(不含等号)
baseRange:数组公式的基础区域范围
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 3 });
initSpread(spread);
};
function initSpread(spread) {
var spreadNS = GC.Spread.Sheets;
var fbx = new spreadNS.FormulaTextBox.FormulaTextBox(document.getElementById('formulaBar'));
fbx.workbook(spread);
var oldArrayRange;
var arrayFormulaStyle = new spreadNS.Style();
arrayFormulaStyle.backColor = "#E0E0FF";
for (var i = 0; i < spread.sheets.length; i++) {
(function (sheet1) {
sheet1.bind(spreadNS.Events.SelectionChanged, null, function (args) {
sheet1.suspendPaint();
var formulaBar = document.getElementById("formulaBar");
var formulaInfo = sheet1.getFormulaInformation(sheet1.getActiveRowIndex(), sheet1.getActiveColumnIndex());
if (oldArrayRange && (!formulaInfo || !formulaInfo.isArrayFormula || !formulaInfo.baseRange.equals(oldArrayRange))) {
for (var r = oldArrayRange.row; r < oldArrayRange.row + oldArrayRange.rowCount; r++) {
for (var c = oldArrayRange.col; c < oldArrayRange.col + oldArrayRange.colCount; c++) {
sheet1.setStyle(r, c, null);
}
}
oldArrayRange = null;
}
if (formulaInfo && formulaInfo.hasFormula) {
var formula = "=" + formulaInfo.formula;
formula = formulaInfo.isArrayFormula ? "{" + formula + "}" : formula;
formulaBar.value=formula;
if (formulaInfo.isArrayFormula && !formulaInfo.baseRange.equals(oldArrayRange)) {
oldArrayRange = formulaInfo.baseRange;
for (var r = oldArrayRange.row; r < oldArrayRange.row + oldArrayRange.rowCount; r++) {
for (var c = oldArrayRange.col; c < oldArrayRange.col + oldArrayRange.colCount; c++) {
sheet1.setStyle(r, c, arrayFormulaStyle);
}
}
}
}
else {
formulaBar.value=sheet1.getValue(sheet1.getActiveRowIndex(), sheet1.getActiveColumnIndex());
}
sheet1.resumePaint();
});
})(spread.sheets[i]);
}
setCalculation(spread.sheets[0]);
setSearch(spread.sheets[1]);
setStatistics(spread.sheets[2]);
}
function setCalculation(sheet) {
sheet.name("计算");
sheet.setArray(0, 0, [
["", "数学", "物理", "化学"],
["李华", 97, 61, 53],
["张伟", 65, 76, 65],
["王强", 55, 70, 64],
["陈杰", 89, 77, 73],
["刘阳", 83, 62, 78],
["赵鹏", 86, 98, 57]
]);
sheet.addSpan(0, 5, 1, 4);
sheet.setValue(0, 5, "计算每个人的总分");
sheet.setArrayFormula(1, 5, 6, 1, "=SUBTOTAL(9,OFFSET($B$2,ROW($A$1:$A$6)-ROW($A$1),,1,3))");
}
function setSearch(sheet) {
sheet.name("查找");
sheet.setArray(0, 0, [
["苹果", "苹果"],
["香蕉", "草莓"],
["豌豆", "土豆"],
["西红柿", "土豆"],
["土豆", "饺子"],
["蛋糕"],
["面条"],
["米饭"],
["汤"]
]);
sheet.addSpan(0, 3, 1, 8);
sheet.setValue(0, 3, "找出B1:B5中第一个不在A1:A9中的值");
sheet.setColumnWidth(3, 80);
sheet.addSpan(2, 3, 1, 2);
sheet.setValue(2, 3, "数组公式结果:");
sheet.setArrayFormula(2, 5, 1, 1, "=INDEX(B1:B5,MATCH(TRUE,ISNA(MATCH(B1:B5,A1:A9,0)),0))");
sheet.getCell(2, 5).backColor("Accent 5 80");
sheet.addSpan(3, 3, 1, 2);
sheet.setValue(3, 3, "普通公式结果:");
sheet.setFormula(3, 5, "=INDEX(B1:B5,MATCH(TRUE,ISNA(MATCH(B1:B5,A1:A9,0)),0))");
sheet.getCell(3, 5).backColor("Accent 6 80");
}
function setStatistics(sheet) {
sheet.name("统计");
sheet.options.allowCellOverflow = true;
sheet.setArray(0, 0, [
["产品", "销售员", "销售数量"],
["传真机", "李三", 1],
["电话", "王四", 10],
["传真机", "张五", 20],
["传真机", "王四", 30],
["电话", "张五", 40],
["电脑", "王四", 50],
["传真机", "李三", 60],
["电话", "赵六", 70],
["电脑", "张五", 80]
]);
sheet.setValue(1, 5, "汇总销售: 李三销售的传真机数量");
sheet.setArrayFormula(2, 5, 1, 1, "=SUM((A2:A10=\"传真机\")*(B2:B10=\"李三\")*(C2:C10))");
sheet.setValue(4, 5, "逻辑与 (传真机 且 李三)");
sheet.setArrayFormula(5, 5, 1, 1, "=SUM((A2:A10=\"传真机\")*(B2:B10=\"李三\"))");
sheet.setValue(7, 5, "逻辑或 (传真机 或 张五)");
sheet.setArrayFormula(8, 5, 1, 1, "=SUM(IF((A2:A10=\"传真机\")+(B2:B10=\"张五\"),1,0))");
sheet.setValue(10, 5, "逻辑异或 (传真机 或 张五,但不同时满足)");
sheet.setArrayFormula(11, 5, 1, 1, "=SUM(IF(MOD((A2:A10=\"传真机\")+(B2:B10=\"张五\"),2),1,0))");
sheet.setValue(13, 5, "逻辑与 (除传真机和张五外的所有销售)");
sheet.setArrayFormula(14, 5, 1, 1, "=SUM(IF((A2:A10=\"传真机\")+(B2:B10=\"张五\")<>2,1,0))");
}
<!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 class="options-container">
<textarea id="formulaBar" rows="10" readonly></textarea>
</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;
}
textarea {
width: 100%;
box-sizing: border-box;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}