概述
本 Demo 展示了如何使用 SpreadJS 的对象属性访问功能，结合 WEBSERVICE 函数从 REST Countries API 查询国家信息。演示了点运算符（.）、溢出区域运算符（#）以及在格式化字符串中使用 @ 符号访问对象属性的方法。
实现思路
启用动态数组功能（allowDynamicArray），支持 FILTERJSON 函数返回数组时自动溢出
使用 WEBSERVICE 函数从 REST Countries API 获取 JSON 数据，URL 根据用户输入动态拼接
使用 FILTERJSON 函数将 JSON 字符串解析为对象数组
使用点运算符和 # 运算符访问对象的嵌套属性（如人口、语言）
在格式化字符串中使用 @ 符号显示对象属性值
代码解析
获取并解析 JSON 数据
这行代码实现了完整的 Web 数据获取流程：
B2 是用户输入的国家名称（如 "united"）
WEBSERVICE 函数向 REST Countries API 发送请求，返回 JSON 字符串
IF(LEN(B2)>3,...) 确保只有当输入长度超过 3 个字符时才发起请求
FILTERJSON 将 JSON 字符串解析为对象数组，由于启用了动态数组，结果会自动溢出到下方单元格
访问对象的嵌套属性
这段代码使用 # 运算符引用 B5 单元格的溢出区域（即 FILTERJSON 返回的整个对象数组），然后使用点运算符访问每个对象的 population 属性。
这行代码展示了访问深层嵌套属性的方式：languages 是一个数组，.0 表示访问第一个元素，再通过 .nativeName 获取母语名称。
在格式化字符串中使用对象属性
格式化字符串中的 @ 符号表示当前单元格的对象值。@.name 访问对象的 name 属性，IFERROR 函数处理可能的错误值。
运行效果
在黄色背景的输入框（B2 单元格）中输入国家名称的部分拼写（如 "united"），表格会自动显示匹配的国家列表
名称列显示国家名称，人口列显示人口数量（千分位格式），语言列显示母语名称
修改输入内容后，数据会自动重新获取并更新
API 参考
WEBSERVICE 函数
url：要请求的 URL 地址，必须支持 CORS（跨域资源共享）
返回值为字符串类型
FILTERJSON 函数
json_string：有效的 JSON 字符串
将 JSON 解析为标量值、对象或对象数组
点运算符与 # 运算符
点运算符（.）：简化版的 PROPERTY 函数，用于访问对象属性
# 运算符：引用动态数组的溢出区域
@ 符号：在格式化字符串中引用当前单元格的对象值
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(_getElementById("ss"));
spread.options.allowDynamicArray = true;
initSpread(spread);
};
function initSpread(spread) {
spread.setSheetCount(1);
spread.suspendPaint();
spread.suspendCalcService();
initSheet1(spread.getSheet(0));
spread.resumeCalcService();
spread.resumePaint();
}
function initSheet1(sheet) {
sheet.suspendPaint();
sheet.name('WebService');
sheet.setColumnWidth(0,27);
sheet.setColumnWidth(1,300);
sheet.setColumnWidth(2,168);
sheet.setColumnWidth(3,168);
sheet.setValue(0, 1, '输入完整或部分国家或地区的名称');
var inputStyle = new GC.Spread.Sheets.Style();
inputStyle.backColor = "#FEF3CD";
sheet.setStyle(1,1,inputStyle);
sheet.setValue(3,1,"名称");
sheet.setValue(3,2,"人口");
sheet.setValue(3,3,"语言");
sheet.setValue(1,1,"united");
var headerStyle = new GC.Spread.Sheets.Style();
headerStyle.backColor = "rgb(222,235,246)";
headerStyle.font = "bold 11pt Calibri";
headerStyle.hAlign = 1;
var borderBottom = new GC.Spread.Sheets.LineBorder;
borderBottom.color = "black";
borderBottom.style = GC.Spread.Sheets.LineStyle.thin;
headerStyle.borderBottom = borderBottom;
sheet.setStyle(3,1,headerStyle);
sheet.setStyle(3,2,headerStyle);
sheet.setStyle(3,3,headerStyle);
for (var r = 4; r < 50; r++) {
sheet.setFormatter(r,1,'=IFERROR(@.name, "")');
sheet.setFormatter(r,2,'#,##0');
sheet.setFormatter(r,3,'#,##0');
}
sheet.setFormula(4,1,'=FILTERJSON(IF(LEN(B2)>3,WEBSERVICE("https://restcountries.com/v2/name/"&B2)))');
sheet.setFormula(4,2,'=B5#.population');
sheet.setFormula(4,3,'=B5#.languages.0.nativeName');
sheet.resumePaint();
}
function _getElementById(id) {
return document.getElementById(id);
}
<!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;
}
