MAKEARRAY 函数

MAKEARRAY 函数通过应用 LAMBDA 函数返回指定行数和列数的计算数组,适用于批量生成具有规律性的数据矩阵。可以创建乘法表、随机值列表等动态数组。

概述 本 Demo 展示了 MAKEARRAY 函数的基本用法,通过两个示例演示如何使用 LAMBDA 函数创建指定大小的数组:第一个示例创建 3x3 乘法表,第二个示例生成 10x5 的随机颜色数组。 实现思路 启用动态数组功能,设置 allowDynamicArray 选项为 true 创建示例标签和说明文本,展示函数用途 第一个示例:使用 MAKEARRAY 创建乘法表,LAMBDA 接收行列索引并返回乘积 第二个示例:使用单元格引用指定数组大小,结合 RANDBETWEEN 和 CHOOSE 生成随机颜色数组 使用 FORMULATEXT 函数显示公式文本,便于查看公式结构 代码解析 启用动态数组功能 MAKEARRAY 是动态数组函数,在使用前需要启用 allowDynamicArray 选项。 示例 1:创建乘法表 此公式创建 3 行 3 列的数组,LAMBDA 函数接收行索引 r 和列索引 c,返回两者的乘积 r*c。结果生成一个乘法表: 示例 2:生成随机颜色数组 此公式使用单元格 C11 和 E11 的值(分别为 10 和 5)作为数组大小。LAMBDA 函数通过 RANDBETWEEN(1,3) 生成 1-3 的随机数,CHOOSE 函数根据随机数返回 "Red"、"Blue" 或 "Green"。 运行效果 第一个示例在 C6 单元格显示 3x3 乘法表,单元格 C5 显示公式文本 第二个示例在 C13 单元格显示 10x5 的随机颜色数组,每次计算会重新生成随机颜色 所有结果数组自动溢出到相邻单元格,无需手动填充 API 参考 MAKEARRAY 函数 rows:数组中的行数,必须大于零 cols:数组中的列数,必须大于零 lambda:调用的 LAMBDA 函数,接收两个参数: row:当前行的索引(从 1 开始) col:当前列的索引(从 1 开始) LAMBDA 函数对数组中的每个单元格调用一次,返回值作为该单元格的结果。 allowDynamicArray 选项 启用动态数组功能后,动态数组函数(如 MAKEARRAY、FILTER、UNIQUE 等)才能正常工作。
var data = { values: { 1: { 1: "示例:" }, 3: { 1: "示例 1: 创建一个表示简单乘法表的二维数组" }, 4: { 1: "公式:" }, 5: { 1: "结果:" }, 9: { 1: "示例 2: 创建一个随机值列表" }, 10: { 1: "行数:", 2: 10, 3: "列数:", 4: 5 }, 11: { 1: "公式:" }, 12: { 1: "结果:" }, }, formulas: { 4: { 2: "FORMULATEXT(C6)" }, 5: { 2: "MAKEARRAY(3,3,LAMBDA(r,c,r*c))" }, 11: { 2: "FORMULATEXT(C13)" }, 12: { 2: 'MAKEARRAY(C11,E11,LAMBDA(row,col,CHOOSE(RANDBETWEEN(1,3),"Red","Blue","Green")))' }, }, cellStyles: { "B2:C2": 0, "B4:H4": 1, B5: 2, "C5:E8": 3, F5: 3, B6: 4, "B10:E10": 1, "B11:B12": 2, C11: 5, D11: 2, E11: 5, "C12:K12": 3, B13: 4, "C13:G22": 6, }, 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: [2, 3, 2, 2] }, { backColor: 4, foreColor: 3, font: 1, border: [3, 3, 3, 3] }, { backColor: 2, foreColor: 1, font: 1, border: [2, 2, 2, 2] }, { backColor: 6, foreColor: 5, border: [3, 3, 3, 3] }, { backColor: 4, foreColor: 7, font: 2, border: [4, 4, 4, 4] }, ], borders: [ { color: "#accdea", style: 5 }, { color: "#9bc3e6", style: 2 }, { color: "#9bc3e6", style: 1 }, { color: "#7f7f7f", style: 1 }, { color: "#000000", style: 1 }, ], colors: ["#44546a", "#ffffff", "#5b9bd5", "#fa7d00", "#f2f2f2", "#3f3f76", "#ffcc99", "#ed7d31"], fonts: ["700 17.3px Calibri", "700 14.7px Calibri", "normal bold 14.7px Calibri"], }, others: { columnWidth: { 0: 30, 8: 72, 9: 72, 10: 72 }, rowHeight: { 1: 24, 2: 21, 3: 21, 9: 21 }, }, }; 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); }); } 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; }