概述
本 Demo 展示了迭代计算的典型应用场景：债务利息递归计算。通过循环引用的公式结构，计算期末债务和利息支出的稳定值。Demo 提供了迭代计算的开关控制，以及最大迭代次数和最大变化量的参数设置，用户可以观察不同参数对计算结果的影响。
实现思路
初始化工作表并设置基础数据（现金收入、利息率、期初债务）
构建债务利息计算的循环引用链：利息支出依赖平均债务，现金利润依赖利息支出，期末债务依赖现金利润，平均债务又依赖期末债务，形成闭环
暂停计算服务（suspendCalcService），避免设置公式时触发自动计算
绑定界面控件事件，允许用户动态调整迭代计算参数
提供重新计算按钮，触发公式重新计算
代码解析
构建循环引用公式链
这段代码构建了一个完整的循环引用链：
B3（利息支出）依赖 B10（利息率）和 B8（平均债务）
B4（现金利润）依赖 B2（现金收入）和 B3（利息支出）
B7（期末债务）依赖 B6（期初债务）和 B4（现金利润）
B8（平均债务）依赖 B6（期初债务）和 B7（期末债务）
这样就形成了一个闭环：期末债务 → 平均债务 → 利息支出 → 现金利润 → 期末债务，需要通过迭代计算逐步逼近稳定值。
暂停和恢复计算服务
在设置多个相互依赖的公式时，使用 suspendCalcService() 暂停计算服务，避免每次设置公式时都触发自动计算，提高性能并防止中间状态错误。设置完成后，使用 resumeCalcService() 恢复计算服务，此时会统一进行计算。
绑定迭代计算参数控制
通过监听界面控件的变化，动态修改工作簿的迭代计算选项：
iterativeCalculation：布尔值，启用或禁用迭代计算
iterativeCalculationMaximumIterations：最大迭代次数，默认 1000，取值范围 1-32767
iterativeCalculationMaximumChange：最大变化量，默认 0.01
点击重新计算按钮会调用 recalcAll(true) 方法，触发所有公式重新计算，用户可以观察不同参数对迭代结果的影响。
运行效果
左侧表格展示债务利息计算：初始现金收入 100、期初债务 150、利息率 5%，通过迭代计算得出期末债务和利息支出的稳定值
勾选或取消勾选"迭代计算"复选框，可以启用或禁用迭代计算功能
修改最大迭代次数或最大变化量参数后，点击"重新计算"按钮，可以观察参数变化对计算结果的影响
当禁用迭代计算时，所有循环引用的单元格值将变为 0
迭代计算会反复计算直到所有值的变化小于最大变化量，或迭代次数达到最大迭代次数为止
API 参考
迭代计算配置
iterativeCalculation：布尔值，启用或禁用迭代计算
iterativeCalculationMaximumIterations：最大迭代次数，默认 1000，取值范围 1-32767
iterativeCalculationMaximumChange：最大变化量，默认 0.01，取值范围 0 至 1.79769313486232e308
recalcAll 方法
refreshAll：可选布尔参数，指定是否重新计算所有公式
该方法已弃用，建议使用 spread.calculate() 替代
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(_getElementById("ss"));
initSpread(spread);
};
function initSpread(spread) {
var sheet = spread.getActiveSheet();
spread.suspendPaint();
spread.suspendCalcService();
sheet.setColumnWidth(0, 120);
sheet.setColumnWidth(1, 100);
sheet.setColumnWidth(2, 120);
sheet.setColumnWidth(4, 120);
sheet.setColumnWidth(5, 130);
sheet.getCell(1, 1).foreColor("blue");
sheet.getCell(5, 1).foreColor("blue");
sheet.getCell(9, 1).foreColor("blue").formatter("0.0%");
sheet.getRange(1, 1, 7, 1).formatter("0.0");
sheet.setFormula(6, 5, '=F7+1');
sheet.setValue(0, 0, "详情");
sheet.setValue(1, 0, "现金收入");
sheet.setValue(2, 0, "利息支出");
sheet.setValue(3, 0, "现金利润");
sheet.setValue(5, 0, "期初债务");
sheet.setValue(6, 0, "期末债务");
sheet.setValue(7, 0, "平均债务");
sheet.setValue(9, 0, "利息");
sheet.setValue(0, 1, "金额");
sheet.setValue(1, 1, 100);
sheet.setFormula(2, 1, '=B10*B8');
sheet.setFormula(3, 1, '=B2-B3');
sheet.setValue(5, 1, 150);
sheet.setFormula(6, 1, '=B6-B4');
sheet.setFormula(7, 1, '=AVERAGE(B6:B7)');
sheet.setValue(9, 1, 0.05);
sheet.setValue(0, 2, "公式")
sheet.setFormula(2, 2, '=FORMULATEXT(B3)');
sheet.setFormula(3, 2, '=FORMULATEXT(B4)');
sheet.setFormula(6, 2, '=FORMULATEXT(B7)');
sheet.setFormula(7, 2, '=FORMULATEXT(B8)');
sheet.getRange(0, 0, 1, 3).backColor("#f2f2f2").foreColor("black");
sheet.getRange(6, 5, 1, 1).backColor("#009e00").foreColor("white");
sheet.getRange(1, 4, 1, 2).backColor("#f2f2f2").foreColor("black");
sheet.getRange(1, 0, 9, 3).setBorder(new GC.Spread.Sheets.LineBorder("#f2f2f2", GC.Spread.Sheets.LineStyle.thin), {all: true});
sheet.getRange(2, 4, 3, 2).setBorder(new GC.Spread.Sheets.LineBorder("#f2f2f2", GC.Spread.Sheets.LineStyle.thin), {all: true});
sheet.setValue(1, 4, "使用莱布尼茨公式近似计算 π")
sheet.setValue(2, 4, "n: 1→∞")
sheet.setValue(3, 4, {"richText":[{"text":"Pn: 4*(-1)"},{"style":{"vertAlign":1},"text":"n+1"},{"text":"/(2n-1)"}],"text":"Pn=4*(-1)n+1/(2n-1)"});
sheet.setValue(4, 4, "π: P1+P2+P3+...+Pn")
sheet.setFormula(4, 5, '=IFERROR(F4,0)+F5');
sheet.setFormula(3, 5, '=IF(F3<1,0,4/(2*F3-1)*POWER(-1,F3+1))');
sheet.setFormula(2, 5, '=F3+1'); // set the n in the last to make sure that added from n=1
spread.resumeCalcService();
spread.resumePaint();
bindEvent(spread);
}
function bindEvent (spread) {
_getElementById("IterativeCalculation").addEventListener('change', function () {
spread.options.iterativeCalculation = this.checked;
});
_getElementById("MaximumIterations").addEventListener('change', function () {
spread.options.iterativeCalculationMaximumIterations = this.value;
});
_getElementById("MaximumChange").addEventListener('change', function () {
spread.options.iterativeCalculationMaximumChange = this.value;
});
_getElementById("RecalcAll").addEventListener('click', function () {
spread.getActiveSheet().recalcAll(true);
});
}
function _getElementById(id) {
return document.getElementById(id);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="spreadjs culture" content="zh-cn" />
<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$/spread/source/js/license.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="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">
<label>修改下方的 <b>最大迭代次数</b> 和 <b>最大更改量</b> 选项，然后点击 <b>重新计算</b>，查看这对单元格 F7 中的计算结果有何影响。</label>
<div class="option-row">
<input style="width: 20px;float: left;" type="checkbox" id="IterativeCalculation" checked="checked" />
<label for="IterativeCalculation">迭代计算</label>
</div>
<div class="option-row">
<label for="MaximumIterations">最大迭代次数:</label>
<input type="number" id="MaximumIterations" value="1000">
</div>
<div class="option-row">
<label for="MaximumChange">最大更改量:</label>
<input type="number" id="MaximumChange" value="0.01">
</div>
<div class="option-row">
<button id="RecalcAll">重新计算</button>
</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;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
.option-row {
font-size: 14px;
padding: 5px;
margin-top: 10px;
}
input {
margin-bottom: 5px;
padding: 2px 4px;
width: 100%;
box-sizing: border-box;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
