概述
本 Demo 展示了如何使用 ISOMITTED 函数检查 LAMBDA 函数中参数是否缺失，并根据检查结果返回不同的值。Demo 中创建了一个接受两个参数的 LAMBDA 函数，当第二个参数缺失时，返回友好的提示文本，而不是错误信息。
实现思路
创建一个包含示例说明、公式和结果的表格结构
使用 FORMULATEXT 函数显示 C6 单元格中的公式文本
在 C6 单元格中设置 LAMBDA 公式，该公式接受两个参数 x 和 y
在 LAMBDA 内部使用 IF 和 ISOMITTED 组合判断参数 y 是否缺失
如果参数缺失，返回提示文本；如果参数存在，则执行加法运算
调用 LAMBDA 函数时，使用 (1,) 故意省略第二个参数，触发 ISOMITTED 检测
代码解析
设置示例公式和结果
这段代码定义了表格中的公式：
第 4 行第 2 列使用 FORMULATEXT(C6) 显示 C6 单元格中的公式文本，方便用户查看实际使用的公式
第 5 行第 2 列设置核心公式：LAMBDA(x,y,IF(ISOMITTED(y),"缺少第二个参数",x+y))(1,)
LAMBDA 函数和 ISOMITTED 的配合使用
这个公式的执行流程：
LAMBDA(x,y,...) 定义了一个接受两个参数的函数
IF(ISOMITTED(y),"缺少第二个参数",x+y) 判断参数 y 是否缺失
如果 ISOMITTED(y) 返回 TRUE，显示提示文本
如果参数存在，执行 x+y 计算
(1,) 调用该 LAMBDA 函数，传入第一个参数为 1，第二个参数被省略
运行效果
表格中显示示例说明文字
第 4 行显示公式文本，方便用户理解公式结构
第 5 行显示计算结果"缺少第二个参数"，因为调用 LAMBDA 时故意省略了第二个参数
用户可以尝试修改调用部分，传入两个参数（如 (1,2)），结果将显示 3（即 1+2）
API 参考
ISOMITTED 函数
argument：要测试的参数，通常是 LAMBDA 函数的参数
返回值：如果参数缺失返回 TRUE，否则返回 FALSE
ISOMITTED 是 LAMBDA 辅助函数之一，专门用于检测 LAMBDA 参数是否缺失，常与 IF 函数配合使用，为缺失参数提供默认值或友好提示。
var data = {
values: {
1: { 1: "示例" },
3: { 1: "示例 1: 检查缺失的参数并返回友好的字符串" },
4: { 1: "公式:" },
5: { 1: "结果:" },
},
formulas: {
4: { 2: "FORMULATEXT(C6)" },
5: { 2: 'LAMBDA(x,y,IF(ISOMITTED(y),"缺少第二个参数",x+y))(1,)' },
},
cellStyles: { "B2:C2": 0, "B4:H4": 1, B5: 2, "C5:I5": 3, B6: 4, "C6:E6": 3 },
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] },
],
borders: [
{ color: "#accdea", style: 5 },
{ color: "#9bc3e6", style: 2 },
{ color: "#9bc3e6", style: 1 },
{ color: "#7f7f7f", style: 1 },
],
colors: ["#44546a", "#ffffff", "#5b9bd5", "#fa7d00", "#f2f2f2"],
fonts: ["700 17.3px Calibri", "700 14.7px Calibri"],
},
others: { columnWidth: { 0: 30 }, rowHeight: { 1: 24, 2: 21, 3: 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;
}
