概述
本 Demo 展示了 MAP 函数的三种典型应用场景：单数组条件转换、多数组逻辑运算以及与 FILTER 函数的组合使用。通过 LAMBDA 函数定义映射规则，实现对数组元素的批量处理。
实现思路
启用动态数组功能（设置 allowDynamicArray 为 true）
准备示例数据：数值数组、布尔表格和多列表格
示例 1：使用 MAP 对单个数组的元素进行条件转换
示例 2：使用 MAP 对两个数组的对应元素进行逻辑运算
示例 3：结合 MAP 和 FILTER 实现复杂条件筛选
代码解析
启用动态数组功能
MAP 函数属于动态数组函数，使用前必须启用 allowDynamicArray 选项。
示例 1：条件转换
MAP 函数遍历 B6:D7 数组的每个元素，LAMBDA 接收一个参数 a，当值大于 4 时返回平方值，否则返回原值（a*1 用于强制转换为数字，避免 #CALC! 错误）。结果是一个与原数组大小相同的转换后数组。
示例 2：多数组逻辑运算
MAP 函数同时遍历两个数组（表格列），LAMBDA 接收两个参数 a 和 b，分别对应两个数组的同位置元素。AND(a,b) 对每行的两个值进行逻辑与运算，返回布尔数组。
示例 3：结合 FILTER 函数
MAP 函数生成布尔数组，标识哪些行符合条件（Size 为 "Large" 且 Color 为 "Red"），FILTER 函数根据这个布尔数组筛选出符合条件的所有行。
运行效果
示例 1：B6:D7 区域的数值 1,2,3,4,5,6 被转换为 1,2,3,4,25,36，其中大于 4 的数变为平方值
示例 2：TableA 表格的两列布尔值经过 AND 运算后，生成新的布尔列，只有两列都为 TRUE 的行返回 TRUE
示例 3：TableB 表格被筛选，只显示 Size 为 "Large" 且 Color 为 "Red" 的行
所有公式都自动填充到结果区域，无需手动拖拽
API 参考
MAP 函数语法
array1：要映射的数组
lambda_or_array<#>：LAMBDA 函数（必须是最后一个参数），或者另一个要映射的数组。LAMBDA 必须为每个传入的数组提供一个参数
LAMBDA 函数
参数数量必须与 MAP 传入的数组数量一致
最后一个参数是计算表达式，定义如何处理数组元素
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 },
7: {
5: "计算最后一个 LAMBDA 参数 a*1 强制将其转换为整数并防止 #CALC! 错误。",
},
10: { 1: "示例 2: 查找一行中两个列都为 TRUE 的值" },
11: { 1: "表格 A:" },
12: { 1: "Col1", 2: "Col2", 5: "公式:" },
13: { 1: false, 2: true, 5: "结果:" },
14: { 1: false, 2: true },
15: { 1: true, 2: true },
16: { 1: false, 2: false },
17: { 1: false, 2: true },
18: { 1: true, 2: false },
19: { 1: true, 2: true },
20: { 1: true, 2: false },
23: { 1: "示例 3: 查找一行中两个列都符合某些条件的值" },
24: { 1: "表格 B:" },
25: { 1: "Size", 2: "Color", 5: "公式:" },
26: { 1: "Medium", 2: "Red" },
27: { 1: "Large", 2: "Green", 6: "有效大小", 7: "有效颜色" },
28: { 1: "Medium", 2: "Blue", 5: "结果:" },
29: { 1: "Medium", 2: "Blue" },
30: { 1: "Medium", 2: "Red" },
31: { 1: "Large", 2: "Red" },
32: { 1: "Medium", 2: "Blue" },
33: { 1: "Small", 2: "Blue" },
34: { 1: "Medium", 2: "Green" },
35: { 1: "Large", 2: "Green" },
},
formulas: {
4: { 6: "FORMULATEXT(G6)" },
5: { 6: "MAP(B6:D7,LAMBDA(a,IF(a>4,a*a,a*1)))" },
12: { 6: "FORMULATEXT(G14)" },
13: { 6: "MAP(TableA[Col1],TableA[Col2],LAMBDA(a,b,AND(a,b)))" },
25: { 6: "FORMULATEXT(G29)" },
28: { 6: 'FILTER(TableB,MAP(TableB[Size],TableB[Color],LAMBDA(s,c,AND(s="Large",c="Red"))))' },
},
cellStyles: {
"B2:C2": 0,
"B4:G4": 1,
B5: 2,
C5: 3,
D5: 4,
"F5:F6": 2,
"G5:I7": 5,
"J5:K5": 5,
"B6:D7": 6,
"F8:K9": 7,
"B11:I11": 1,
"B12:C12": 8,
"F13:F14": 2,
"G13:G21": 5,
"H13:L13": 5,
"B24:J24": 1,
"B25:C25": 8,
F26: 2,
"G26:K27": 9,
"G28:H28": 2,
F29: 2,
"G29:H29": 5,
},
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, null, 3, 4] },
{ backColor: 2, foreColor: 1, font: 1, border: [2, null, 3] },
{ backColor: 2, foreColor: 1, font: 1, border: [2, 4, 3] },
{ backColor: 4, foreColor: 3, font: 1, border: [3, 3, 3, 3] },
{ backColor: 6, foreColor: 5, border: [3, 3, 3, 3] },
{ backColor: 7, wordWrap: true, border: [5, 5, 5, 5] },
{ foreColor: 0, font: 1 },
{ backColor: 4, foreColor: 3, font: 1, wordWrap: true, border: [3, 3, 3, 3] },
],
borders: [
{ color: "#accdea", style: 5 },
{ color: "#9bc3e6", style: 2 },
{ color: "#000000", style: 1 },
{ color: "#7f7f7f", style: 1 },
{ color: "#9bc3e6", style: 1 },
{ color: "#b2b2b2", style: 1 },
],
colors: ["#44546a", "#ffffff", "#5b9bd5", "#fa7d00", "#f2f2f2", "#3f3f76", "#ffcc99", "#ffffcc"],
fonts: ["700 17.3px Calibri", "700 14.7px Calibri"],
},
others: {
columnWidth: { 0: 30 },
rowHeight: { 1: 24, 2: 21, 3: 21, 10: 21, 23: 21 },
spans: ["B5:D5", "F8:K9", "G26:K27"],
tables: [
{ name: "TableA", ref: "B13:C21" },
{ name: "TableB", ref: "B26:C36" },
],
},
};
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);
}
// set tables
var tables = data.others.tables || [];
for (var i = 0; i < tables.length; i++) {
var table = tables[i];
var range = sheet.getRange(table.ref);
sheet.tables.add(table.name, 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;
}
