序列化

SpreadJS支持自定义单元格类型，自定义函数，自定义格式器，自定义标签和自定义sparklineEx的序列化。

序列化后，自定义类型的 toJSON 方法存储一个指示自身的字符串字段类型。字符串类型与窗口相关，例如“ mynamespace.MyCellType”。反序列化后， getTypeFromString 方法通过解析类型字符串获取自定义类型，然后创建该自定义类型的实例，然后调用该实例的 fromJSON 方法。

如果将实际类型字符串分配给自定义类型的type字段，则将对自定义类型进行序列化和反序列化。如果自定义类型具有循环依赖关系，或者您想减小JSON大小或有其他要求，则自定义类型还需要覆盖 toJSON 和 fromJSON 方法。

如果不想将自定义类型放在窗口对象上，则还需要重写 getTypeFromString 方法来解析类型字符串。

示例代码

本示例使用spread1的toJSON和spread2的fromJSON函数来实现将所有数据从spread1序列化为spread2。选择按钮后，“ MyTag”实例位于spread2上。

<!DOCTYPE html>
<html>
<head>
<title>Spread HTML test page</title>
 <link type="text/css" href="./css/gc.spread.sheets.13.0.0.css" rel="stylesheet" />
 <script src="http://code.jquery.com/jquery-2.0.2.js" type="text/javascript"></script>
 <script type="text/javascript" src="./scripts/gc.spread.sheets.all.13.0.0.min.js"></script>
<script type="text/javascript">
//自定义标签
         function MyTag(name, age) {
         this.name = name;
         this.age = age;
         this.typeName = "MyTag";
     }
     MyTag.prototype.toJSON = function () {
         var settings = {};
         settings.name = this.name;
         settings.age = this.age;
         settings.typeName = this.typeName;
         return settings;
     };
     MyTag.prototype.fromJSON = function (settings) {
         this.name = settings.name;
         this.age = settings.age;
         this.typeName = settings.typeName;
     };
     $(function () {
var spread1 = new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
         var sheet1 = spread1.getActiveSheet();
         sheet1.tag(new MyTag("Ivy", 24));
         sheet1.setTag(0, 0, new MyTag("Yang", 25));
         $("#btn1").click(function () {
             //序列化ss到ss1.
                 var jsonStr = JSON.stringify(spread1.toJSON());
           
var spread2 = new GC.Spread.Sheets.Workbook(document.getElementById("ss1"),{sheetCount:3});
             spread2.fromJSON(JSON.parse(jsonStr));
             var sheet2 = spread2.getActiveSheet();
             alert("Tag of sheet:" + JSON.stringify(sheet2.tag()));
             alert("Tag of Cell[0,0]: " + JSON.stringify(sheet2.getTag(0, 0)));
         });
     });
</script>
 </head>
 <body>
 <div>
     <div id="ss" style="height: 200px; width: 500px"></div>
         <div id="ss1" style="height: 200px; width: 500px"></div>
     </div>
     <input type="button" id="btn1" value="Serialization" />
 </body>
 </html>