@grapecity-software/spread-excelio 17.0.2

package/README.md

@@ -0,0 +1,17 @@
+# SpreadJS Client-Side Excel IO
+
+客户端 Excel IO 软件包是 [SpreadJS](https://www.grapecity.com.cn/developer/spreadjs) 的插件之一。
+
+它通过在客户端扩展 SpreadJS，实现了 Excel 的导入和导出：XLSX 格式转换为 SpreadJS JSON 格式，以及 SpreadJS JSON 格式转换为 XLSX 格式。
+
+有关 SpreadJS 模块和插件的详细列表，请参见 [SpreadJS 组件库](https://demo.grapecity.com.cn/spreadjs/help/docs/getstarted/modules)
+
+## 安装模块/插件
+```sh
+npm install @grapecity-software/spread-excelio
+```
+
+## 获取更多帮助
+想需要获取更多产品信息，请浏览 [SpreadJS 主页](https://www.grapecity.com.cn/developer/spreadjs)
+
+您可以在论坛中提出任何您使用产品过程中遇到的问题： [技术支持论坛](https://gcdn.grapecity.com.cn/showforum-232-1.html)

package/dist/gc.spread.excelio.d.ts

@@ -0,0 +1,122 @@
+declare module GC{
+    module Spread{
+        module Excel{
+
+            export class IO{
+                /**
+                 * Represents an excel import and export class.
+                 * @class
+                 */
+                constructor();
+                /**
+                 * Imports an excel file.
+                 * @param {Blob} file The excel file.
+                 * @param {function} successCallBack Call this function after successfully loading the file. `function (json) { }`.
+                 * @param {function} errorCallBack Call this function if an error occurs. The exception parameter object structure `{ errorCode: GC.Spread.Excel.IO.ErrorCode, errorMessage: string}`.
+                 * @param {GC.Spread.Excel.IO.OpenOptions} options The options for import excel.
+                 * @returns {void}
+                 * @example
+                 * ```
+                 * var workbook = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
+                 * var excelIO = new GC.Spread.Excel.IO();
+                 * var excelFile = document.getElementById("fileDemo").files[0];
+                 * excelIO.open(excelFile, function (json) {
+                 *    workbook.fromJSON(json);
+                 * }, function (e) {
+                 *    console.log(e);
+                 * }, {
+                 *    password: "password",
+                 *    importPictureAsFloatingObject: false
+                 * });
+                 * ```
+                 */
+                open(file: Blob,  successCallBack: Function,  errorCallBack?: Function,  options?: GC.Spread.Excel.IO.OpenOptions): void;
+                /**
+                 * Register a unknown max digit width info to ExcelIO.
+                 * @param {string} fontFamily The font family of default style's font.
+                 * @param {number} fontSize The font size of default style's font(in point).
+                 * @param {number} maxDigitWidth The  max digit width of default style's font.
+                 * @returns {void}
+                 */
+                registerMaxDigitWidth(fontFamily: string,  fontSize: number,  maxDigitWidth: number): void;
+                /**
+                 * Creates and saves an excel file with the SpreadJS json.
+                 * @param {object} json The spread sheets json object, or string.
+                 * @param {function} successCallBack Call this function after successfully exporting the file. `function (blob) { }`.
+                 * @param {function} errorCallBack Call this function if an error occurs. The exception parameter object structure `{ errorCode: GC.Spread.Excel.IO.ErrorCode, errorMessage: string}`.
+                 * @param {GC.Spread.Excel.IO.SaveOptions} options The options for export excel.
+                 * @returns {void}
+                 * @example
+                 * ```
+                 * var workbook = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
+                 * var excelIO = new GC.Spread.Excel.IO();
+                 * var json = JSON.stringify(workbook.toJSON());
+                 * excelIO.save(json, function (blob) {
+                 *    saveAs(blob, fileName); //saveAs is from FileSaver.
+                 * }, function (e) {
+                 *    console.log(e);
+                 * }, {
+                 *    password: "password",
+                 *    xlsxStrictMode: false
+                 * });
+                 * ```
+                 */
+                save(json: string | object,  successCallBack: Function,  errorCallBack?: Function,  options?: GC.Spread.Excel.IO.SaveOptions): void;
+            }
+            module IO{
+
+                /**
+                 * @typedef GC.Spread.Excel.IO.OpenOptions - The options for import excel.
+                 * @property {string} password the excel file's password.
+                 * @property {boolean} importPictureAsFloatingObject import picture as floatingObject instead of shape.
+                 */
+                export type OpenOptions = 
+                    {
+                        password?: string;
+                        importPictureAsFloatingObject?: boolean;
+                    }
+                
+
+                /**
+                 * @typedef GC.Spread.Excel.IO.SaveOptions - The options for export excel.
+                 * @property {string} password the excel file's password.
+                 * @property {boolean} xlsxStrictMode the mode of exporting process, the non-strict mode may reduce the export size. Default is true.
+                 */
+                export type SaveOptions = 
+                    {
+                        password?: string;
+                        xlsxStrictMode?: boolean;
+                    }
+                
+                /**
+                 * Specifies the excel io error code.
+                 * @enum {number}
+                 */
+                export enum ErrorCode{
+                    /**
+                     *  File read and write exception.
+                     */
+                    fileIOError= 0,
+                    /**
+                     *  Incorrect file format.
+                     */
+                    fileFormatError= 1,
+                    /**
+                     *  The Excel file cannot be opened because the workbook/worksheet is password protected.
+                     */
+                    noPassword= 2,
+                    /**
+                     *  The specified password is incorrect.
+                     */
+                    invalidPassword= 3
+                }
+
+            }
+
+        }
+
+    }
+
+}
+
+ export = GC.Spread.Excel;