office-viewer 0.2.0 → 0.3.0

package/lib/excel/render/ui/Radio.js

@@ -0,0 +1,56 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var tslib = require('tslib');
+
+var radioId = 0;
+/**
+ * radio 的简单封装
+ */
+var Radio = /** @class */ (function () {
+    function Radio(container, options, defaultValue, onChange) {
+        var e_1, _a;
+        var radioWrapper = document.createElement('div');
+        container.appendChild(radioWrapper);
+        radioWrapper.className = 'excel-radio-wrapper';
+        var _loop_1 = function (option) {
+            var id = "".concat(radioId++, "-").concat(option.value);
+            var radio = document.createElement('input');
+            radio.type = 'radio';
+            radio.value = option.value;
+            radio.checked = option.value === defaultValue;
+            radio.name = 'excel-radio';
+            radio.id = id;
+            radio.onchange = function () {
+                onChange === null || onChange === void 0 ? void 0 : onChange(radio.value);
+            };
+            radioWrapper.appendChild(radio);
+            var label = document.createElement('label');
+            label.innerText = option.text;
+            label.htmlFor = id;
+            radioWrapper.appendChild(label);
+        };
+        try {
+            for (var options_1 = tslib.__values(options), options_1_1 = options_1.next(); !options_1_1.done; options_1_1 = options_1.next()) {
+                var option = options_1_1.value;
+                _loop_1(option);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (options_1_1 && !options_1_1.done && (_a = options_1.return)) _a.call(options_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        this.element = radioWrapper;
+    }
+    Radio.prototype.getValue = function () {
+        var radio = this.element.querySelector('input:checked');
+        return radio === null || radio === void 0 ? void 0 : radio.value;
+    };
+    return Radio;
+}());
+
+exports.Radio = Radio;

package/lib/excel/render/ui/Select.d.ts

@@ -0,0 +1,13 @@
+export type SelectOption = {
+    value: string;
+    text: string;
+};
+export declare class Select<ValueType extends string> {
+    element: HTMLSelectElement;
+    constructor(container: HTMLElement, options: Array<{
+        value: ValueType;
+        text: string;
+    }>, defaultValue: ValueType, onChange: (value: string) => void);
+    setValue(value: string): void;
+    getValue(): ValueType;
+}

package/lib/excel/render/ui/Select.js

@@ -0,0 +1,33 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var Select = /** @class */ (function () {
+    function Select(container, options, defaultValue, onChange) {
+        var element = document.createElement('select');
+        container.appendChild(element);
+        this.element = element;
+        element.className = 'excel-select';
+        options.forEach(function (option) {
+            var optionElement = document.createElement('option');
+            optionElement.value = option.value;
+            optionElement.textContent = option.text;
+            if (option.value === defaultValue) {
+                optionElement.selected = true;
+            }
+            element.appendChild(optionElement);
+        });
+        element.addEventListener('change', function () {
+            onChange(element.value);
+        });
+    }
+    Select.prototype.setValue = function (value) {
+        this.element.value = value;
+    };
+    Select.prototype.getValue = function () {
+        return this.element.value;
+    };
+    return Select;
+}());
+
+exports.Select = Select;

package/lib/excel/render/widget/Widget.d.ts

@@ -0,0 +1,29 @@
+/**
+ * canvas 渲染中的小部件
+ */
+import type { Canvas } from '../Canvas';
+export declare abstract class Widget {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    ratio: number;
+    canvas: Canvas;
+    constructor(x: number, y: number, width: number, height: number, canvas: Canvas);
+    getClientBounding(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    updateScale(): void;
+    updateX(x: number): void;
+    updateY(y: number): void;
+    /**
+     * 判断某个坐标点是否在这个小部件内
+     */
+    isPointInWidget(x: number, y: number): boolean;
+    onMouseover(): void;
+    onMouseout(): void;
+    abstract draw(): Promise<ImageData>;
+}

package/lib/excel/sheet/BuiltInNumFmt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 内置 numfmt，来自 ssf.js，做了修改，主要是将 yy 都改成了 yyyy，不然太容易混淆了
+ */
+declare const BuiltInNumFmt: string[];
+export default BuiltInNumFmt;

package/lib/excel/sheet/BuiltInNumFmt.js

@@ -0,0 +1,43 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 内置 numfmt，来自 ssf.js，做了修改，主要是将 yy 都改成了 yyyy，不然太容易混淆了
+ */
+var BuiltInNumFmt = [];
+BuiltInNumFmt[0] = 'General';
+BuiltInNumFmt[1] = '0';
+BuiltInNumFmt[2] = '0.00';
+BuiltInNumFmt[3] = '#,##0';
+BuiltInNumFmt[4] = '#,##0.00';
+BuiltInNumFmt[9] = '0%';
+BuiltInNumFmt[10] = '0.00%';
+BuiltInNumFmt[11] = '0.00E+00';
+BuiltInNumFmt[12] = '# ?/?';
+BuiltInNumFmt[13] = '# ??/??';
+// 将原本的 yy 改成 yyyy 了，并换了顺序
+BuiltInNumFmt[14] = 'yyyy/m/d';
+// 将原本的 yy 改成 yyyy 了，并换了顺序
+BuiltInNumFmt[15] = 'yyyy-mmm-d';
+BuiltInNumFmt[16] = 'mmm-d';
+// 将原本的 yy 改成 yyyy 了，并换了顺序
+BuiltInNumFmt[17] = 'yyyy-mmm';
+BuiltInNumFmt[18] = 'h:mm AM/PM';
+BuiltInNumFmt[19] = 'h:mm:ss AM/PM';
+BuiltInNumFmt[20] = 'h:mm';
+BuiltInNumFmt[21] = 'h:mm:ss';
+// 将原本的 yy 改成 yyyy 了，并换了顺序
+BuiltInNumFmt[22] = 'yyyy/m/d h:mm';
+BuiltInNumFmt[37] = '#,##0 ;(#,##0)';
+BuiltInNumFmt[38] = '#,##0 ;[Red](#,##0)';
+BuiltInNumFmt[39] = '#,##0.00;(#,##0.00)';
+BuiltInNumFmt[40] = '#,##0.00;[Red](#,##0.00)';
+BuiltInNumFmt[45] = 'mm:ss';
+BuiltInNumFmt[46] = '[h]:mm:ss';
+BuiltInNumFmt[47] = 'mmss.0';
+BuiltInNumFmt[48] = '##0.0E+0';
+BuiltInNumFmt[49] = '@';
+BuiltInNumFmt[56] = '"上午/下午 "hh"時"mm"分"ss"秒 "';
+
+exports["default"] = BuiltInNumFmt;

package/lib/excel/sheet/ColWidth.d.ts

@@ -0,0 +1,19 @@
+/**
+ * col 宽度相关的工具函数
+ */
+/**
+ * 用于根据字符数获取列宽
+ * @returns 返回宽度像素
+ */
+export declare function baseColWidth2px(colWidth: number, fontWidth: number): number;
+/**
+ * 根据列宽获取 px，这个减去 0.83203125 是 Excel 默认加的
+ * 这个计算方法可能不太准，还得进一步调研
+ * @param colWidth
+ * @returns 返回宽度像素
+ */
+export declare function colWidth2px(colWidth: number, fontWidth: number): number;
+/**
+ * 根据像素反算列宽
+ */
+export declare function px2colWidth(px: number, fontWidth: number): number;

package/lib/excel/sheet/ColWidth.js

@@ -0,0 +1,36 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * col 宽度相关的工具函数
+ */
+/**
+ * 用于根据字符数获取列宽
+ * @returns 返回宽度像素
+ */
+function baseColWidth2px(colWidth, fontWidth) {
+    // 文档（P.1685）里的说法是
+    // defaultColWidth = baseColumnWidth + {margin padding (2 pixels on each side, totalling 4 pixels)} + {gridline (1pixel)}
+    // 所以这里加 5
+    return colWidth * fontWidth + 5;
+}
+/**
+ * 根据列宽获取 px，这个减去 0.83203125 是 Excel 默认加的
+ * 这个计算方法可能不太准，还得进一步调研
+ * @param colWidth
+ * @returns 返回宽度像素
+ */
+function colWidth2px(colWidth, fontWidth) {
+    return baseColWidth2px(colWidth - 0.83203125, fontWidth);
+}
+/**
+ * 根据像素反算列宽
+ */
+function px2colWidth(px, fontWidth) {
+    return (px - 5) / fontWidth + 0.83203125;
+}
+
+exports.baseColWidth2px = baseColWidth2px;
+exports.colWidth2px = colWidth2px;
+exports.px2colWidth = px2colWidth;

package/lib/excel/sheet/ExcelRenderOptions.d.ts

@@ -0,0 +1,149 @@
+import { RenderOptions } from '../../RenderOptions';
+import { HitTestResult } from '../render/selection/hitTest';
+export interface RowColHeadersOptions {
+    /**
+     * 是否显示表头，这个会覆盖默认设置
+     */
+    showRowColHeaders: boolean;
+    /**
+     * 字体颜色
+     */
+    rowColHeadersColor: string;
+    /**
+     * 表头背景色
+     */
+    rowColHeadersBackgroundColor: string;
+    /**
+     * 表头线颜色
+     */
+    rowColHeadersLineColor: string;
+    /**
+     * 有隐藏内容时的字体颜色
+     */
+    hiddenRowColHeadersColor: string;
+    /**
+     * 有隐藏内容时的线颜色
+     */
+    hiddenRowColHeadersLineColor: string;
+    /**
+     * 有隐藏内容时的线大小
+     */
+    hiddenRowColHeadersLineSize: number;
+}
+export interface GridLineOptions {
+    /**
+     * 是否显示网格线
+     */
+    showGridLines?: boolean;
+    /**
+     * 网格线宽度
+     */
+    gridLineWidth?: number;
+    /**
+     * 网格线颜色
+     */
+    gridLineColor: string;
+    /**
+     * 拖动网格线时的颜色
+     */
+    dragGridLineColor: string;
+    /**
+     * 冻结线宽度
+     */
+    frozenLineWidth?: number;
+    /**
+     * 冻结线颜色
+     */
+    frozenLineColor: string;
+    /**
+     * 点击到线上的范围，当鼠标靠近这个距离内时，会认为点击到了线上
+     */
+    gridLineHitRange: number;
+}
+export interface SelectionOptions {
+    /**
+     * 选中的边框颜色
+     */
+    selectionBorderColor: string;
+    /**
+     * 选中区域右下角的方块大小
+     */
+    selectionSquareSize: number;
+    /**
+     * 选中区域的背景色
+     */
+    selectionBackgroundColor: string;
+    /**
+     * 选中区域的背景色透明度
+     */
+    selectionBackgroundOpacity: number;
+}
+export interface Debug {
+    /**
+     * 鼠标移动时的回调，主要用于调试
+     */
+    mousePositionTracker?: (x: number, y: number, hitTestResult: HitTestResult | null) => void;
+}
+export interface ExcelRenderOptions extends RenderOptions, RowColHeadersOptions, GridLineOptions, SelectionOptions, Debug {
+    /**
+     * 是否使用 web worker 避免解析时卡顿，默认不开启
+     */
+    useWorker?: boolean;
+    /**
+     * 是否加载时强制计算所有公式，这个在 workbook 的 calcPr 中也能配置
+     */
+    fullCalcOnLoad?: boolean;
+    /**
+     * 渲染宽度
+     */
+    width?: number;
+    /**
+     * 渲染高度
+     */
+    height?: number;
+    /**
+     * 语言，使用 http://www.rfc-editor.org/rfc/bcp/bcp47.txt，主要用于 numfmt
+     */
+    locale: string;
+    /**
+     * 缩放比例
+     */
+    scale?: number;
+    /**
+     * 单个缩进大小
+     */
+    indentSize: number;
+    /**
+     * 背景色
+     */
+    backgroundColor: string;
+    /**
+     * 单元格默认背景色
+     */
+    cellBackgroundColor: string;
+    /**
+     * 是否显示公式栏
+     */
+    showFormulaBar: boolean;
+    /**
+     * 是否显示 sheet 标签
+     */
+    showSheetTabBar: boolean;
+    /**
+     * 嵌入模式，在这个模式下滚动条滚到底部会出发继续滚动事件，滚动页面本身
+     */
+    embed: boolean;
+    /**
+     * 是否可编辑
+     */
+    editable: boolean;
+    /**
+     * 打印可以覆盖其它配置
+     */
+    printOptions?: ExcelRenderOptions;
+    printWaitTime?: number;
+    /**
+     * 字体 url，用于加载字体
+     */
+    fontURL: Record<string, string>;
+}

package/lib/excel/sheet/RangeCache.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 范围缓存，方便数据变化的时候自动清空
+ */
+import { RangeRef } from '../types/RangeRef';
+/**
+ * 范围的缓存 key
+ */
+export declare function rangeCacheKey(range: RangeRef): string;
+export declare function rangeCacheKeyToRange(key: string): {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+};
+export declare class RangeCache {
+    /**
+     * 缓存
+     */
+    private cache;
+    /**
+     * 设置缓存
+     */
+    set(ranges: RangeRef[], key: string, value: any): void;
+    /**
+     * 获取缓存
+     */
+    get(ranges: RangeRef[], key: string): any;
+    /**
+     * 清理相关缓存，会判断是否相交
+     */
+    clear(ranges: RangeRef[]): void;
+}

package/lib/excel/sheet/RangeCache.js

@@ -0,0 +1,105 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var tslib = require('tslib');
+var Range = require('../io/excel/util/Range.js');
+
+/**
+ * 范围缓存，方便数据变化的时候自动清空
+ */
+/**
+ * 范围的缓存 key
+ */
+function rangeCacheKey(range) {
+    return "".concat(range.startRow, "-").concat(range.startCol, "-").concat(range.endRow, "-").concat(range.endCol);
+}
+function rangeCacheKeyToRange(key) {
+    var _a = tslib.__read(key.split('-'), 4), startRow = _a[0], startCol = _a[1], endRow = _a[2], endCol = _a[3];
+    return {
+        startRow: parseInt(startRow, 10),
+        startCol: parseInt(startCol, 10),
+        endRow: parseInt(endRow, 10),
+        endCol: parseInt(endCol, 10)
+    };
+}
+var RangeCache = /** @class */ (function () {
+    function RangeCache() {
+        /**
+         * 缓存
+         */
+        this.cache = new Map();
+    }
+    /**
+     * 设置缓存
+     */
+    RangeCache.prototype.set = function (ranges, key, value) {
+        var cacheKey = ranges.map(rangeCacheKey).join(' ');
+        if (!this.cache.has(cacheKey)) {
+            this.cache.set(cacheKey, new Map());
+        }
+        this.cache.get(cacheKey).set(key, value);
+    };
+    /**
+     * 获取缓存
+     */
+    RangeCache.prototype.get = function (ranges, key) {
+        var cacheKey = ranges.map(rangeCacheKey).join(' ');
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey).get(key);
+        }
+        return null;
+    };
+    /**
+     * 清理相关缓存，会判断是否相交
+     */
+    RangeCache.prototype.clear = function (ranges) {
+        var e_1, _a, e_2, _b, e_3, _c;
+        try {
+            for (var ranges_1 = tslib.__values(ranges), ranges_1_1 = ranges_1.next(); !ranges_1_1.done; ranges_1_1 = ranges_1.next()) {
+                var range = ranges_1_1.value;
+                try {
+                    for (var _d = (e_2 = void 0, tslib.__values(this.cache.keys())), _e = _d.next(); !_e.done; _e = _d.next()) {
+                        var rangeKeys = _e.value;
+                        var cacheRanges = rangeKeys.split(' ').map(rangeCacheKeyToRange);
+                        try {
+                            for (var cacheRanges_1 = (e_3 = void 0, tslib.__values(cacheRanges)), cacheRanges_1_1 = cacheRanges_1.next(); !cacheRanges_1_1.done; cacheRanges_1_1 = cacheRanges_1.next()) {
+                                var cacheRange = cacheRanges_1_1.value;
+                                if (Range.rangeIntersect(range, cacheRange)) {
+                                    this.cache.delete(rangeKeys);
+                                    break;
+                                }
+                            }
+                        }
+                        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                        finally {
+                            try {
+                                if (cacheRanges_1_1 && !cacheRanges_1_1.done && (_c = cacheRanges_1.return)) _c.call(cacheRanges_1);
+                            }
+                            finally { if (e_3) throw e_3.error; }
+                        }
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (_e && !_e.done && (_b = _d.return)) _b.call(_d);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (ranges_1_1 && !ranges_1_1.done && (_a = ranges_1.return)) _a.call(ranges_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    };
+    return RangeCache;
+}());
+
+exports.RangeCache = RangeCache;
+exports.rangeCacheKey = rangeCacheKey;
+exports.rangeCacheKeyToRange = rangeCacheKeyToRange;

package/lib/excel/sheet/RowFilter.d.ts

@@ -0,0 +1,3 @@
+/**
+ * 行过滤配置
+ */