概述
本 Demo 展示了 INDIRECT 函数的多种用法,包括使用文本字符串直接引用、通过单元格值动态引用、字符串拼接构建引用以及跨工作表引用。Demo 还提供了交互功能,允许用户创建自定义名称并在 INDIRECT 公式中使用。
实现思路
创建工作簿并初始化两个工作表,设置基础数据
在第一个工作表中展示多种 INDIRECT 公式的使用方式
提供用户交互界面,允许输入自定义名称和引用对象
点击按钮后,通过 addCustomName 方法创建自定义名称,并在 INDIRECT 公式中使用
代码解析
设置基础数据
这段代码为两个工作表设置基础数据,这些数据将被 INDIRECT 函数动态引用。
展示不同的 INDIRECT 用法
这段代码展示了 INDIRECT 的六种使用方式:直接文本引用、单元格引用、字符串拼接、动态拼接、跨工作表拼接和跨工作表直接引用。
添加自定义名称
用户输入自定义名称后,调用 addCustomName 方法创建名称,然后在 INDIRECT 公式中使用该名称进行动态引用。
运行效果
表格中显示多个 INDIRECT 公式的示例及其描述,结果列自动计算并显示引用的单元格值
表格上方显示随机数和当前时间,展示 INDIRECT 与易失性函数的配合使用
用户可以在右侧面板输入自定义名称(如 name1)和引用对象(如 $A$1),点击按钮后在表格中添加新的 INDIRECT 示例
如果自定义名称定义了有效的单元格引用,结果列显示引用的值;否则显示 #REF! 错误
API 参考
addCustomName 方法
name:自定义名称的标识符
formula:名称引用的公式或单元格区域
baseRow、baseCol:相对引用的基准行和列
comment:可选,名称的备注说明
isReadOnly:可选,是否为只读名称
setFormula 方法
row、col:单元格位置
value:公式字符串
sheetArea:可选,表单区域
INDIRECT 函数
ref_text:必需,包含单元格引用的文本字符串
a1:可选,指定引用样式(TRUE 为 A1 样式,FALSE 为 R1C1 样式)
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 2 });
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
var sheet = spread.sheets[0], sheet2 = spread.sheets[1];
sheet.setArray(0, 0, [["b1", 1], ["A", 2], ["B", 3]]);
sheet2.setArray(0, 0, [["b3", 1], ["A", 3], ["B", 5]]);
sheet.setValue(3, 0, "随机数");
sheet.setFormula(3, 1, "=RANDBETWEEN(1,100)");
sheet.setValue(4, 0, "当前时间");
sheet.setFormula(4, 1, "=NOW()");
sheet.getRange(4, 1, 1, 1).formatter("mm-dd-yyyy");
sheet.setArray(8, 0, [["公式", "描述", "结果"]]);
sheet.setColumnWidth(0, 165);
sheet.setColumnWidth(1, 285);
var sampleData = [
['=INDIRECT("A1")', 'A1单元格的值 => "b1"'],
['=INDIRECT(A1)', 'A1引用的值 => b1单元格的值 => 1'],
['=INDIRECT("A"&(1+2))', 'A3单元格的值 => "B"'],
['=INDIRECT(A3&B2)', 'B2单元格的值 => 2'],
['=INDIRECT("Sheet2!"&A1)', 'Sheet2工作表中B1单元格的值'],
['=INDIRECT("Sheet2!A1")', 'Sheet2工作表中A1单元格的值']
];
for (var i = 0, len = sampleData.length; i < len; i++) {
var data = sampleData[i], row = 6 + i;
sheet.setArray(row, 0, [data]);
sheet.setFormula(row, 2, data[0]);
}
spread.resumePaint();
document.getElementById("btnAddCustomName").addEventListener('click', function () {
var name = document.getElementById("customName").value,
ref = document.getElementById("customReference").value,
row = 15;
if (name) {
try {
sheet.addCustomName(name, ref, 0, 0);
sheet.setArray(row, 0, [[`=INDIRECT(${name})`, `${name} 是一个自定义名称,如果它定义了有效的单元格引用,则使用该值,否则显示 #REF!`]]);
sheet.setFormula(row, 2, '=INDIRECT(' + name + ')');
} catch (e) {
alert("无效的自定义名称");
}
}
});
}
<!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">
<div class="option-row">
<label class="colorLabel">在下方输入自定义名称并设置其引用内容。然后点击“添加自定义名称”按钮将其添加到 Spread 中,以便在单元格中使用。</label>
</div>
<div class="option-row">
<label class="sizedLabel">自定义名称:</label>
<input type="text" value="name1" id="customName" />
</div>
<div class="option-row">
<label class="sizedLabel">引用对象:</label>
<input type="text" value="$A$1" id="customReference" />
</div>
<div class="option-row">
<input type="button" id="btnAddCustomName" value="添加自定义名称" title="为示例添加自定义名称" />
</div>
</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;
overflow: auto;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
}
.option-row {
margin-bottom: 12px;
}
input {
width: 100%;
padding: 4px 6px;
margin-bottom: 6px;
box-sizing: border-box;
}
input[type=button] {
width: auto;
}
label {
display: block;
margin-bottom: 6px;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}