xframelib 0.8.7 → 0.8.9

package/dist/utils/FileDownload.d.ts

@@ -3,13 +3,13 @@
  * @param content 文本或二进制文件
  * @param filename 文件名
  */
-declare const Download: (content: string | any, filename: string) => void;
+declare const Download: (content: ArrayBufferView | ArrayBuffer | Blob | string, filename: string) => void;
 /**
- * URL方式保存文件到本地
+ * URL方式保存文件到本地（下载文件夹下）
  * @param data 文件的blob数据
  * @param name 文件名
  */
-declare function SaveAs(data: string | any, name: string): void;
+declare function SaveAs(data: ArrayBufferView | ArrayBuffer | Blob | string, name: string): void;
 /**
  * JSON对象下载为.json文件
  * @param jsonObject Json对象
@@ -24,4 +24,12 @@ declare const JsonDownload: (jsonObject: object, jsonID: string) => void;
  * @param fileName 文件名
  */
 declare const HttpDownload: (axios: any, requestUrl: string, fileName: string) => void;
-export { Download, SaveAs, JsonDownload, HttpDownload };
+/**
+ * 对话框选择，保存选定路径的文件
+ * @param filename 文件名
+ * @param blob 文件内容
+ * @param done 回调函数
+ * @returns
+ */
+declare function SaveToSelectedFile(filename: string, blob: Blob | File, doneCallBack: (err?: string, result?: any) => void): Promise<void>;
+export { Download, SaveAs, JsonDownload, HttpDownload, SaveToSelectedFile };

package/dist/utils/FilenameUtils.d.ts

@@ -0,0 +1,14 @@
+export declare function parseLocalPath(path: any): {
+    filename: string;
+    directory: string;
+    basename: string;
+    extension: string;
+};
+export declare function getFileBase(path: any): string;
+export declare function getFileExtension(path: any): string;
+export declare function getPathBase(path: any): any;
+export declare function replaceFileExtension(path: any, ext: any): any;
+export declare function toLowerCaseExtension(name: any): any;
+export declare function getCommonFileBase(names: any): any;
+export declare function mergeNames(name1: string, name2: string): any;
+export declare function findStringPrefix(a: string, b: string): string;

package/dist/utils/GzipTool.d.ts

@@ -0,0 +1,27 @@
+export interface IGzipFile {
+    name: string;
+    content: Uint8Array | string | ArrayBuffer;
+}
+/**
+ * Gzip压缩解压
+ */
+export default class GzipTool {
+    static runningInBrowser(): boolean;
+    static isGzipped(arg: any): boolean;
+    static gzipSync(content: any, opts: any): Uint8Array<ArrayBufferLike> | undefined;
+    static gzipAsync(content: Uint8Array | string, opts: any): Promise<unknown>;
+    /**
+     * 直接读取压缩包文件，解压
+     * @param file File文件内容
+     * @returns
+     */
+    static readGzipFromFile(file: File): Promise<IGzipFile[]>;
+    /**
+     * 读压缩包文件内容，解压
+     * @param gzipfile
+     * @returns
+     */
+    static readGzipFile(gzipfile: IGzipFile): IGzipFile[];
+    static gunzipAsync(buf: any, opts: any): Promise<any>;
+    static gunzipSync(buf: any, filename: any): Uint8Array | string | any;
+}

package/dist/utils/H5Tool.d.ts

@@ -305,10 +305,66 @@ export default class H5Tool {
    * @returns {HTMLElement}
    */
     static createVideoHTML(url: string, className: string, container?: HTMLElement): HTMLElement;
+    /**
+     * 以Promise方式读前端文件
+     * @param file 文件或BLob
+     * @param type 类型'FileBytes'|'ArrayBuffer'|'Text'|'BinaryString'|'DataURL'，默认为ArrayBuffer
+     * @param encoding 文本编码,默认为UTF-8
+     * @returns
+     */
+    static readFilePromise(file: File | Blob, type?: 'FileBytes' | 'ArrayBuffer' | 'Text' | 'BinaryString' | 'DataURL', encoding?: string): Promise<string | ArrayBuffer>;
     /**
      * 读取前端文件，为bytes二进制数组（base64编码的）
      * @param file
      * @returns
      */
     static readFileBytes(file: File | Blob): Promise<any>;
+    /**
+     * 将链式异步方法（最后一个参数为cb回调函数），改为promise异步方法
+     * @param asyncFun
+     * @param args 正常业务参数
+     * @returns
+     */
+    static promisify(asyncFun: Function, ...args: any[]): () => Promise<unknown>;
+    /**
+     * 异步等待多少ms
+     * @param ms 多少毫秒
+     * @returns
+     */
+    static wait(ms: number): Promise<unknown>;
+    /**
+     * 停止冒泡事件传递
+     * @param e
+     */
+    static blockEvent(e: any): void;
+    /**
+     * 给DIV对象绑定拖拽文件事件
+     * @param ele id或classname或 HtmlElement对象
+     * @param onDropFile 接收文件拖拽列表_回调函数
+     */
+    static bindDropFileHanlder(ele: string | Element, onDropFile: (fileList: FileList) => {}): void;
+    /**
+     * 获取正在输入或编辑内容的Element
+     * @returns input等
+     */
+    static getInputElement(): Element | null;
+    /**
+     * 将粘贴的文本，保存为文件
+     * @param content 粘贴文本内容
+     * @returns
+     */
+    private static guessPasteTextToFileName;
+    private static pasteEventHanlder;
+    /**
+     * 使用document
+     * 绑定粘贴事件（粘贴字符串、URL或文件）
+     * 不是任意DIV都可以绑定粘贴
+     * 如果 div 元素不可编辑，通常情况下是无法触发 paste 事件的。只有设置了 contenteditable="true" 的元素，才会在用户粘贴内容时触发该事件.
+     * @param onPasteCallback 粘贴的回调函数
+     */
+    static onPasteHandler(onPasteCallback: (pasteContent: string | Array<File> | undefined) => {}): void;
+    /**
+     * 移除document粘贴处理事件
+     */
+    static offPasteHandler(): void;
 }

package/dist/utils/IsTool.d.ts

@@ -99,3 +99,15 @@ export declare function isMap(source: unknown): boolean;
  * @returns
  */
 export declare const isValidURL: (url: string) => boolean;
+/**
+ * 文本内容是否是JSON
+ * @param content
+ * @returns
+ */
+export declare function isStringLikeJson(content: string): boolean;
+/**
+ * 文本内容是KML
+ * @param content
+ * @returns
+ */
+export declare function isStringLikeKml(content: string): boolean;

package/dist/utils/ZipTool.d.ts

@@ -0,0 +1,60 @@
+import { Unzipped, FlateCallback } from "fflate";
+export interface IZipFile {
+    filename: string;
+    content: Uint8Array | string | ArrayBuffer;
+}
+/**
+ * zip压缩和解压
+ */
+export default class ZipTool {
+    static runningInBrowser(): boolean;
+    /**
+     * 保存文件到本地
+     * @param zipfileName zip文件名
+     * @param files 压缩文件数组
+     */
+    static saveZipFile(zipfileName: string, files: Array<IZipFile>): void;
+    /**
+     * 同步解压压缩包
+     * @param input
+     * @returns
+     */
+    static unzipSync(input: ArrayBuffer | Uint8Array): Unzipped | undefined;
+    /**
+     * 直接读取压缩包文件，解压
+     * @param file File文件内容
+     * @returns
+     */
+    static readZipFromFile(file: File): Promise<IZipFile[]>;
+    /**
+     * 读压缩包文件内容，解压
+     * @param zipfile
+     * @returns
+     */
+    static readZipFile(zipfile: {
+        content: any;
+        name: string;
+    }): Promise<IZipFile[]>;
+    /**
+     * 异步解压更快
+     * @param buf
+     * @param cb 回调函数
+     */
+    static unzipAsync(buf: ArrayBuffer | Uint8Array, cb: (err: any, data?: Unzipped) => {}): void;
+    /**
+     * 同步压缩
+     * @param files
+     * @returns
+     */
+    static zipSync(files: Array<IZipFile>): Uint8Array;
+    /**
+     * 异步压缩
+     * @param files
+     * @param cb
+     */
+    static zipAsync(files: Array<IZipFile>, cb: FlateCallback): void;
+    private static fflateFilter;
+    private static fflatePostprocess;
+    private static isImportableZipPath;
+    private static fflatePreprocess;
+}

package/dist/utils/index.d.ts

@@ -2,6 +2,8 @@ import H5Tool from './H5Tool';
 import StringUtils from './StringUtils';
 import StorageHelper, { storage } from './Storage';
 import uuid, { newGuid } from './uuid';
+import ZipTool from './ZipTool';
+import GzipTool from './GzipTool';
 export * from './Color';
 export * from './FileDownload';
 export * from './Time';
@@ -18,4 +20,5 @@ export * from './ValidateTool';
 import XXTEA from './XXTEA';
 import WaterMark from './WaterMark';
 import { GetSignalRClient } from './SignalrClient';
-export { GetSignalRClient, WaterMark, XXTEA, H5Tool, StringUtils, StorageHelper as Storage, storage, uuid, newGuid };
+export * from './FilenameUtils';
+export { GetSignalRClient, WaterMark, XXTEA, H5Tool, StringUtils, StorageHelper as Storage, storage, uuid, newGuid, ZipTool, GzipTool };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xframelib",
-  "version": "0.8.7",
+  "version": "0.8.9",
   "description": "积累的前端开发基础库",
   "main": "dist/index.js",
   "common": "dist/index.cjs",
@@ -34,6 +34,7 @@
     "@iconify/vue": "^4.2.0",
     "@microsoft/signalr": "^8.0.7",
     "axios": "^1.7.9",
+    "fflate": "^0.8.2",
     "localforage": "^1.10.0",
     "loglevel": "^1.9.2",
     "qs": "^6.13.1",