概述
本 Demo 展示了 TRIMRANGE 函数的使用方法，该函数可以从区域或数组的边缘开始扫描，自动排除空白行和空白列，返回修剪后的有效数据范围。Demo 还演示了修剪引用（Trim Refs）这一简便的速记语法，无需显式调用函数即可实现相同的修剪效果。
实现思路
加载预设的表格数据（通过 fromJSON 方法加载包含 TRIMRANGE 公式的表格）
触发表格计算（调用 calculate 方法执行公式计算）
展示 TRIMRANGE 函数对不同数据区域的修剪效果
演示修剪引用的简写语法及其等效功能
代码解析
加载并计算表格
这段代码通过 fromJSON 加载预设的表格数据，其中包含使用 TRIMRANGE 函数和修剪引用语法的公式示例。调用 calculate() 方法确保所有公式被正确计算，suspendPaint 和 resumePaint 用于优化渲染性能。
TRIMRANGE 函数语法
函数从区域边缘扫描，排除空白行和列：
range：必需，要修剪的区域或数组
trim_rows：可选，修剪行的模式
0 - 不修剪
1 - 修剪开头的空行
2 - 修剪末尾的空行
3 - 修剪开头和末尾的空行（默认值）
trim_cols：可选，修剪列的模式
0 - 不修剪
1 - 修剪开头的空列
2 - 修剪末尾的空列
3 - 修剪开头和末尾的空列（默认值）
修剪引用示例
修剪引用通过在冒号运算符中添加点号（.）实现简写，无需显式调用 TRIMRANGE 函数。
运行效果
表格中展示了使用 TRIMRANGE 函数处理后的数据范围，空白行和列被自动排除
不同参数组合展示了修剪开头、末尾或两侧空白的不同效果
通过修剪引用语法（如 A1.:.E10）可以更简洁地实现相同功能
用户可以编辑原始数据，观察修剪后的区域如何动态调整
API 参考
TRIMRANGE 函数
返回修剪后的区域引用，从边缘扫描并排除空白行列。
注意事项
不适用于三维引用（如 Sheet1:Sheet3!A:A）
不能直接用于创建动态数据透视表
修剪引用符号（.: . 或 :.）不是运算符，不能与 INDIRECT 等函数组合使用
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 1 });
initSpread(spread);
};
function initSpread(spread) {
var sd = data;
if (sd.length > 0) {
if (!spread) {
return;
}
spread.suspendPaint();
spread.fromJSON(sd[0]);
spread.calculate();
spread.resumePaint();
}
}
<!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$/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="$DEMOROOT$/spread/source/data/trimrange.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" style="width:100%;height:100%"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
