数组公式用例

SpreadJS 支持数组公式,可以在多个单元格上执行批量计算,用单个公式替代多个普通公式,实现更高效的数据处理和复杂逻辑运算。本 Demo 展示了数组公式在批量计算、数据查找和多条件统计等场景中的应用。

概述 本 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; }