表格加了些自定义扩展。格子里画小菱形,公式调自己写的函数,表上挂着负责人的标签。等工作簿存进数据库或换个页面打开,有的格子变回普通内容。
SpreadJS 是浏览器里的 JavaScript 电子表格控件,工作簿能转成 JSON 保存和还原。扩展跟不跟着走,看序列化这一关。
JSON 里只剩 typeName
toJSON() 把值、公式、样式和标签变成普通数据。单元格类型、自定义函数、格式化器,留下的线索通常是 typeName。名字还在,代码不在。
调用 fromJSON() 时,SpreadJS 拿这个字符串找同名构造函数。找不到,模板再打开,扩展就没了。
JSON 只负责数据,代码得先在页面里。
命名空间类型走默认,私有类型改写查找
demo 有两条路。MyFunction 和 MySparklineEx 的 typeName 带 mynamespace. 前缀,构造函数挂在 mynamespace 上,查找走默认逻辑。MyFormatter 和 MyRowFilter 定义在 initSpread 内部,外面拿不到,demo 改写 GC.Spread.Sheets.getTypeFromString 找回它们。
var oldFun = GC.Spread.Sheets.getTypeFromString;
GC.Spread.Sheets.getTypeFromString = function (typeString) {
switch (typeString) {
case "MyFormatter":
return MyFormatter;
case "MyRowFilter":
return MyRowFilter;
default:
return oldFun.apply(this, arguments);
}
};
var jsonStr = JSON.stringify(spread1.toJSON());
spread2.fromJSON(JSON.parse(jsonStr));
先存下原方法。switch 命中时返回构造函数,其余交回 oldFun,内置类型还靠它。toJSON() 结果转成字符串,另一个 Workbook 用 fromJSON() 接住。改写放在 fromJSON() 前,顺序不能反。
标签对象要自己补序列化方法
工作表和单元格标签都用了 MyTag。它没登记成类型,SpreadJS 不知道 {name, age} 怎么变回 MyTag。MyTag 自己实现 toJSON,写出 typeName、name、age,再实现 fromJSON,从 settings 读字段。typeName 那行标了 necessary,少了它,恢复时认不出这是谁。
点按钮,两个工作簿的 sheet.tag() 和 sheet.getTag(0, 0) 都打到控制台,name 和 age 对得上,标签走完了全程。
六张表,六种扩展各走一遍
六张表各放一种扩展。MyCellType 用 paint 描出绿色菱形,MySparklineEx 的 CIRCLE() 画橙色圆,两个都靠 canvas 绘制,值不变。MyFunction 注册后,MyFunction() 返回当天日期;MyFormatter 把数字 1 显示成 One。标签和行筛选是另一类,一个随表或格子带对象,一个在筛选后给留下的行刷红底。
状态灯、等级条适合画在格子里,工作日计算这类逻辑可以包成自定义函数。审核人、版本号挂在标签上。RowFilterBase 的 onFilter 改一改就能标出风险行。
自定义类型要赶在 fromJSON 之前就位
接口是 Workbook.toJSON、Workbook.fromJSON、typeName 和 GC.Spread.Sheets.getTypeFromString。挂扩展用 Worksheet.setCellType、Worksheet.addCustomFunction、Worksheet.setFormatter、Workbook.addSparklineEx,行筛选用 Worksheet.rowFilter 和 RowFilterBase。标签用 Worksheet.tag、Worksheet.setTag。
这套机制让 JSON 带上类型名,代码仍要由页面提供。自定义类型的脚本要在 fromJSON() 前加载,换版本时别改 typeName,旧文件还等着它认领。demo 只校验了标签,另外几种扩展没有单独验证。