概述
这个 demo 演示了 TableSheet 中空值显示的自定义方式。示例数据同时包含 null、undefined 对应场景和空字符串，页面通过 showNullAs 与 showEmptyAs 为不同列设置替代文本，让空数据在表格中以更明确的形式呈现出来。
实现思路
创建 Workbook，通过 dataManager() 管理表格数据，并准备包含空值的示例数据。
在 addTable 的 schema.columns 中，为 Name、Email、Score 和 JoinDate 配置表结构级别的空值显示规则。
新建 TableSheet 工作表，并通过 addView 定义视图列。
在视图列中继续为 Phone 和 Notes 配置 showNullAs、showEmptyAs，演示视图级别的空值显示能力。
调用 myView.fetch() 获取视图数据，再用 sheet.setDataView(myView) 将结果绑定到工作表。
代码解析
首先，demo 准备了一组包含多种空值情况的示例数据，便于观察不同配置下的显示效果：
接着，在表结构级别配置部分列的空值显示规则。这种方式适合为字段定义默认展示行为：
然后，demo 创建 TableSheet 视图，并在视图列中为 Phone、Notes 补充列级别的空值显示配置。这样可以在不改动表结构的前提下，单独控制当前视图中的显示文本：
最后，通过获取视图数据并绑定到工作表，让配置立即生效：
这段逻辑的关键点在于：同一个 demo 同时展示了“表结构级别配置”和“视图级别配置”两种做法，便于比较不同层级的空值显示策略。
运行效果
工作表会显示一个 TableSheet 页签，列头为“姓名”“邮箱”“电话”“分数”“加入日期”“备注”等中文标题。
当字段值为 null 时，会显示如 [空值]、[无电话]、[无日期] 这类替代文本。
当字段值为空字符串时，会显示如 [空字符串]、[空白]、[无备注] 这类替代文本。
Score 列中的空值会显示为 0，JoinDate 列会按 M/d/yy 格式显示有效日期。
API 参考
spread.dataManager()：获取数据管理器，用于创建表和视图。
dataManager.addTable(...)：基于数据源和列结构创建数据表。
myTable.addView(...)：为数据表创建视图列配置。
myView.fetch()：获取视图数据。
sheet.setDataView(myView)：将视图绑定到 TableSheet 工作表。
/*REPLACE_MARKER*/
/*DO NOT DELETE THESE COMMENTS*/
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 0 });
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
var dataManager = spread.dataManager();
// 使用包含 null 和空字符串的数据来演示空值显示效果
var sampleData = [
{ Id: 1, Name: "张伟", Email: "zhangwei@example.com", Phone: "123-456-7890", Score: 85, JoinDate: "2023-01-15", Notes: "普通客户" },
{ Id: 2, Name: "王芳", Email: "", Phone: "234-567-8901", Score: null, JoinDate: null, Notes: null },
{ Id: 3, Name: "李娜", Email: null, Phone: "", Score: 92, JoinDate: "2023-06-20", Notes: "" },
{ Id: 4, Name: "刘洋", Email: "liuyang@example.com", Phone: null, Score: 78, JoinDate: null, Notes: "VIP 会员" },
{ Id: 5, Name: "陈杰", Email: "", Phone: null, Score: null, JoinDate: "2024-03-10", Notes: "" },
{ Id: 6, Name: "赵敏", Email: "zhaomin@example.com", Phone: "345-678-9012", Score: 88, JoinDate: null, Notes: "新会员" },
{ Id: 7, Name: "孙涛", Email: "suntao@example.com", Phone: null, Score: 95, JoinDate: "2024-07-05", Notes: null },
{ Id: 8, Name: "周静", Email: "", Phone: "456-789-0123", Score: null, JoinDate: null, Notes: "" },
{ Id: 9, Name: "吴倩", Email: null, Phone: "567-890-1234", Score: 72, JoinDate: "2024-12-01", Notes: "高级用户" },
{ Id: 10, Name: "郑欣", Email: "zhengxin@example.com", Phone: "", Score: null, JoinDate: null, Notes: null },
];
// 方式 1：在表结构级别配置（Name、Email、Score、JoinDate）
var myTable = dataManager.addTable("myTable", {
data: sampleData,
schema: {
columns: {
Id: { dataType: "number" },
Name: { showNullAs: "[空值]", showEmptyAs: "[空字符串]" },
Email: { showNullAs: "[空值]", showEmptyAs: "[空字符串]" },
Score: { showNullAs: "0", dataType: "number" },
JoinDate: { showNullAs: "[无日期]", dataType: "date" }
// Phone 和 Notes 不在表结构级别配置，改为在视图级别配置
}
}
});
var sheet = spread.addSheetTab(0, "空值显示", GC.Spread.Sheets.SheetType.tableSheet);
// 方式 2：在视图级别配置（Phone、Notes）
var myView = myTable.addView("myView", [
{ value: "Id", caption: "ID", width: 60 },
{ value: "Name", caption: "姓名", width: 150 },
{ value: "Email", caption: "邮箱", width: 200 },
// 在视图级别为 Phone 和 Notes 单独配置空值显示
{ value: "Phone", caption: "电话", width: 130, showNullAs: "[无电话]", showEmptyAs: "[空白]" },
{ value: "Score", caption: "分数", width: 80, style: { hAlign: "right" } },
{ value: "JoinDate", caption: "加入日期", width: 150, style: { hAlign: "right", formatter: "M/d/yy" } },
{ value: "Notes", caption: "备注", width: 180, showNullAs: "[空值]", showEmptyAs: "[无备注]" }
]);
myView.fetch().then(function() {
sheet.setDataView(myView);
});
spread.resumePaint();
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="spreadjs culture" content="zh-cn" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<!-- Promise Polyfill for IE, https://www.npmjs.com/package/promise-polyfill -->
<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>
<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$/zh/purejs/node_modules/@grapecity-software/spread-sheets-tablesheet/dist/gc.spread.sheets.tablesheet.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 id="optionContainer" class="optionContainer">
</div>
</div>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
.sample-spreadsheets {
width: 100%;
height: 100%;
overflow: hidden;
float: left;
}
