halo-fe 1.0.32 → 1.0.34

package/esm/driver/util/@type/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./DomBound";
+export * from "./DomRect";
+export * from "./JsonConfig";
+export * from "./Ref";
+export * from "./TreeNodeProp";

package/esm/driver/util/BaseUtil.d.ts

@@ -0,0 +1,7 @@
+import { IUtil } from "./IUtil";
+/**
+ * 帮助类基类
+ */
+export declare abstract class BaseUtil implements IUtil {
+    type: string;
+}

package/esm/driver/util/IUtil.d.ts

@@ -0,0 +1,7 @@
+import { IDriver } from "../@type";
+/**
+ * 工具接口
+ * 跟Helper的不同是：可实例化后执行工具方法，可以集中管理
+ */
+export interface IUtil extends IDriver {
+}

package/esm/driver/util/UtilFactory.d.ts

@@ -0,0 +1,34 @@
+import { Factory } from "../../factory";
+import { IUtil } from "./IUtil";
+import { ArrayUtil, BrowserUtil, ComponentUtil, DictionaryUtil, DomUtil, EventUtil, FileUtil, HtmlUtil, ImageUtil, JsonUtil, MathUtil, MicroUtil, MountUtil, ObjectUtil, ScrollUtil, SignUtil, StringUtil, TaskUtil, TimeUtil, TreeUtil, UrlUtil } from "./implement";
+/**
+ * 帮助类工厂
+ */
+export declare class UtilFactory extends Factory<IUtil> {
+    type: string;
+    open(): void;
+    get array(): ArrayUtil;
+    get browser(): BrowserUtil;
+    get component(): ComponentUtil;
+    get dom(): DomUtil;
+    get dictionary(): DictionaryUtil;
+    get event(): EventUtil;
+    get file(): FileUtil;
+    get html(): HtmlUtil;
+    get image(): ImageUtil;
+    get json(): JsonUtil;
+    /**
+     * 数学帮助类
+     */
+    get math(): MathUtil;
+    get mount(): MountUtil;
+    get object(): ObjectUtil;
+    get micro(): MicroUtil;
+    get scroll(): ScrollUtil;
+    get string(): StringUtil;
+    get task(): TaskUtil;
+    get time(): TimeUtil;
+    get tree(): TreeUtil;
+    get url(): UrlUtil;
+    get sign(): SignUtil;
+}

package/esm/driver/util/implement/ArrayUtil.d.ts

@@ -0,0 +1,137 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 数组帮助类
+ */
+export declare class ArrayUtil extends BaseUtil {
+    type: string;
+    /**
+     * 获取指定数组分成每片指定长度后的集合
+     */
+    getChunks: (entities: any[], size: number) => any[][];
+    /**
+     * 获取分成指定片数量后的集合
+     */
+    getChunksByCount(entities: any[], count: number): any[][];
+    /**
+     * 获取指定开始位置的指定数量的集合
+     */
+    getRange<T>(entities: T[], index: number, count?: number): T[];
+    /**
+     * 获取最后length个元素
+     */
+    getLast(entities: string[], length: number): string[];
+    /**
+     * 取两个集合的交集
+     */
+    intersect: (arr1: any[], arr2: any[]) => any[];
+    /**
+     * 排除指定元素（差集）
+     */
+    except: (from: any[], target: any[] | any, equals?: (a: any, b: any) => boolean) => any[];
+    /**
+     * 求最大值，数据类型的比较函数要自己转换为数值类型
+     */
+    max<T>(entities: T[], fn: (entity: T) => number): T;
+    /**
+     * 求最小值，数据类型的比较函数要自己转换为数值类型
+     */
+    min<T>(entities: T[], fn: (entity: T) => number): any;
+    /**
+     * 求平均值
+     */
+    avg<T>(entities: T[], fn: (entity: T) => number, digits?: number): number;
+    /**
+     * 对数组的指定属性求和
+     * 指定保留小数位，可以防止浮点数计算精度问题，如：57.16+14.29=71.44999999999999 正确得到：71.45
+     */
+    sum<T>(entities: T[], fn: (entity: T) => number, digits?: number): number;
+    /**
+     * 存在属性匹配值
+     */
+    any<T>(entities: T[], value: any, ...props: string[]): T;
+    /**
+     * 是否包含
+     */
+    contains: (arr: any[], element: any) => boolean;
+    /**
+     * 判断指定集合中的指定属性的值，是否包含关键词
+     */
+    filterContains: (arr: any[], props: string[], keywords: string) => any[];
+    /**
+     * 判断2个数组是否每个元素都相同
+     */
+    same: (arr1: any[], arr2: any[]) => boolean;
+    /**
+     * 对数组元素根据指定函数进行去重，并返回去重后的值的新数组 n=>n.value
+     */
+    distinct<T>(entities: T[], selector: (entity: T) => any): any[];
+    /**
+     * 创建集合
+     */
+    from(entities: any): any[];
+    /**
+     * 连接值构建成新数组，重复项也会自动构建，不存在的值，会自动创建为一个新项
+     */
+    fromValues: (arrValues: any[], arr: any[], propertyValue: string, propertyText: string) => any[];
+    /**
+     * 分割指定字符串为数组，字符串为空，返回空数组
+     * @param input
+     * @param split
+     * @param element 转换后添加的默认元素
+     */
+    split: (input: string, split: string, element?: any) => any[];
+    /**
+     * 合并多个数组中的每一项到新的二维数组中，没值的元素被有值的元素代替
+     */
+    combine<T>(...args: T[]): any[];
+    /**
+     * 在指定元素前插入新元素，返回插入元素的索引
+     */
+    insert<T>(entities: T[], selectedRow: T, row: T): number;
+    /**
+     * 在指定元素后插入新元素，返回插入元素的索引
+     */
+    append<T>(entities: T[], selectedRow: T, row: T): number;
+    /**
+     * 不存在某元素时才添加某元素
+     */
+    pushIfNotExist<T>(entities: T[], element: T): void;
+    /**
+     * 把集合创建成另一个集合
+     */
+    create<T>(entities: any[], handler: (entity: any, i: number) => T): T[];
+    /**
+     * 删除执行数组中的指定对象或者集合
+     */
+    remove<T>(entities: T[], element: T | T[]): void;
+    /**
+     * 删除指定元素，并返回删除后的字符串
+     */
+    removeIndex: (str: string, index: number, split: string) => string;
+    /**
+     * 按照指定属性对数组排序
+     */
+    orderBy<T>(entities: T[], sortFn: ((entity: T) => any) | ((entity: T) => any)[], asc?: boolean): T[];
+    /**
+     * 按照指定对比函数对数组排序，不改变原始数组，返回升序数组
+     ** 对比结果：1:a大 0:相同 -1:b大
+     ** 支持多属性比对
+     */
+    sort<T>(entities: T[], compareFn: (a: T, b: T) => number): T[];
+    /**
+     * 分组，封装成字典而不是集合，大数据场景速度提升百倍
+     */
+    groupBy: (entities: any[], keyHandler: (entity: any) => any, valueHandler?: (item: any[]) => any) => object;
+    /**
+     * 分组
+     */
+    groupByArray: (entities: any[], keyFn: (item: any) => any) => any[];
+    /**
+     * 替换指定元素为新元素，不存在则添加
+     */
+    replaceOrAdd(entities: any[], selectFn: (value: any) => boolean, replacement: any): void;
+    /**
+     * 把实体，自动转换成数组
+     */
+    getArray<T>(entity: T | T[]): T[];
+}

package/esm/driver/util/implement/BrowserUtil.d.ts

@@ -0,0 +1,11 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 多语言帮助类
+ */
+export declare class BrowserUtil extends BaseUtil {
+    type: string;
+    /**
+     * 获取浏览器默认语言
+     */
+    getLanguage(): "zh-cn" | "en";
+}

package/esm/driver/util/implement/ComponentUtil.d.ts

@@ -0,0 +1,36 @@
+import { Ref, VNode } from "vue";
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 组件帮助类
+ */
+export declare class ComponentUtil extends BaseUtil {
+    type: string;
+    /**
+     * 根据动态加载的组件对象，得到组件集合
+     */
+    getComponents(components: object, replace: string, prefix?: string): object;
+    /**
+     * 获取部分自定义组件名称
+     */
+    getName: (url: string, prefix: string) => string;
+    /**
+     * 检测异步控件是否加载完毕
+     */
+    detectLoaded(ref: any, cb: Function): void;
+    /**
+     * 把属性传值，转换成外部引用对象，未传值则转换成内部引用对象
+     */
+    toRef<T>(props: any, name: string, value: T): Ref<T>;
+    /**
+     * 获取指定名字的虚拟节点
+     */
+    getNode(slots: any, name: string): VNode;
+    /**
+     * 根据虚拟节点集合获取虚拟节点
+     */
+    toNode(slot: any): VNode;
+    /**
+     * 从插槽中，获取指定名称插槽的虚拟节点集合
+     */
+    getNodes(slots: any, name: string): VNode[];
+}

package/esm/driver/util/implement/DictionaryUtil.d.ts

@@ -0,0 +1,39 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 字典帮助类
+ */
+export declare class DictionaryUtil extends BaseUtil {
+    type: string;
+    /**
+     * 从指定字典中提取忽略大小写的key的值
+     */
+    getValueIgnoreCase<T>(key: string, value: {
+        [key: string]: T;
+    }): T;
+    /**
+     * 对字典进行排序，并得到新字典
+     */
+    sort(obj: object): any;
+    /**
+     * 连接字典
+     */
+    join(obj: object, valueHandler?: (value: string) => string, delimiter?: string, join?: string): string;
+    /**
+     * 把字典转换成数组
+     */
+    toList(entity: {
+        [key: string]: any[];
+    }, valueHandler: (entity: {
+        key: string;
+        value: any;
+    }) => void): {
+        key: string;
+        value: any[];
+    }[];
+    /**
+     * 判断字典是否包含值
+     */
+    containsValue(dic: {
+        [key: string]: any;
+    }, value: any): boolean;
+}

package/esm/driver/util/implement/DomUtil.d.ts

@@ -0,0 +1,171 @@
+import { Position } from "../../utility";
+import { BaseUtil } from "../BaseUtil";
+import { DomBound } from "../@type";
+/**
+ * Dom帮助类
+ */
+export declare class DomUtil extends BaseUtil {
+    type: string;
+    /**
+     * 根据字符串Ascii码得到固定颜色字典
+     */
+    getColors(values: string[]): object;
+    /**
+     * 获取样式名
+     */
+    getClass(...args: any[]): string;
+    /**
+     * 添加类
+     */
+    addClass: (element: Element, cls: string, choice?: any) => void;
+    /**
+     * 删除类
+     */
+    removeClass: (selector: string | Element, className: string, except?: Element) => void;
+    /**
+     * 根据计算后的样式进行DOM过滤
+     */
+    filterStyle(element: HTMLElement[], fn: (style: CSSStyleDeclaration) => boolean): HTMLElement[];
+    /**
+     * 添加样式
+     */
+    addStyle(element: HTMLElement, prop: string, value: string): void;
+    /**
+     * 查找兄弟节点
+     */
+    siblings(element: HTMLElement): HTMLElement[];
+    /**
+     * 查找指定父节点
+     */
+    parentUntil(element: HTMLElement, cls: string): HTMLElement;
+    /**
+     * 查找指定父节点集合
+     */
+    parentsUntil(element: HTMLElement, cls: string): HTMLElement[];
+    /**
+     * 查找第一个影响fixed定位的 绝对定位元素 或 backdrop 元素，直到html元素
+     */
+    parentAbsolute(element: HTMLElement): HTMLElement;
+    /**
+     * 查找孩子节点
+     */
+    find(element: Element, cls: string): Element;
+    /**
+     * 统计所有控件宽度，含外边距
+     */
+    getWidth(element: Element | Element[]): number;
+    /**
+     * 获取元素可用宽度（移除内填充）
+     */
+    getAvailableWidth(element: Element | Element[]): number;
+    /**
+     * 统计所有非固定定位控件高度，含内填充和外边距
+     ** 会自动忽略空元素
+     */
+    getHeight(element: Element | Element[]): number;
+    /**
+     * 获取元素可用高度（移除内填充）
+     */
+    getAvailableHeight(element: Element | Element[]): number;
+    /**
+     * 获取指定元素在视口内的位置
+     */
+    getViewportStyle(element: Element, title: string, subMenu: string, viewport: Element, position: string): any;
+    /**
+     * 获取指定选择器元素的最大索引，并排除指定元素
+     */
+    getMaxIndex(selector: string, except: Element): number;
+    /**
+     * 判断当前鼠标位置是否在指定范围之内
+     */
+    inRange(event: Position, x: number, y: number, width: number, height: number): boolean;
+    /**
+     * 创建指定标签的dom，并设置内容
+     */
+    create(name: string, cls?: string, html?: string): HTMLElement;
+    /**
+     * 不存在时创建dom，并自动追加到文档
+     */
+    createIfAbsent(name: string, cls: string, html?: string): HTMLElement;
+    /**
+     * 根据路径获取标签（无src）
+     */
+    createEmptyByUrl: (url: string) => HTMLElement;
+    /**
+     * 根据路径获取待加载的元素，同时包含Url
+     */
+    createByUrl: (url: string) => HTMLElement;
+    /**
+     * 根据路径获取元素
+     * VIP：已废弃，不能用改方法判断资源是否加载完毕，因为可能只是脚本创建，资源还未加载完毕
+     */
+    getByUrl: (url: string) => HTMLElement;
+    /**
+     * 获取行内标签，如: style（非link）
+     */
+    getInlineTagByUrl(url: string): string;
+    /**
+     * 获取资源标签，如: link
+     */
+    getTagByUrl(url: string): string;
+    /**
+     * 滚动指定dom到可视窗口
+     */
+    scrollIntoView(value: HTMLElement): void;
+    /**
+     * 获取指定元素滚动条滚动的百分比
+     */
+    getScrollPercent(element: Element): number;
+    /**
+     * 获取文本实际占用宽度
+     */
+    getTextWidth(value: string): number;
+    /**
+     * 判断指定元素相比另一个元素内容是否溢出，需要设置该元素高度占比100%
+     */
+    isOverflow: (element: Element, compareTo: Element) => boolean;
+    /**
+     * 获取指定元素相对于fixed定位元素的位置
+     */
+    getAbsoluteRect(value: HTMLElement): DOMRect;
+    /**
+     * 获取指定元素距离目标元素左上右下边缘的距离
+     */
+    getRectBound(target: HTMLElement, to: HTMLElement): DomBound;
+    /**
+     * 获取指定元素距离目标元素左上右下边缘的距离
+     */
+    getEventBound(event: MouseEvent, to: HTMLElement): DomBound;
+    /**
+     * 获取指定元素相对于指定元素的位置
+     */
+    getRectTo(to: HTMLElement, value: HTMLElement): DOMRect;
+    /**
+     * 获取元素相对窗口（非第一个fixed元素）的位置和占据的总宽高
+     ** width:实际占据的总宽度（含边框和填充）
+     ** height:实际占据的总高度（含边框和填充）
+     */
+    getRect(target: HTMLElement): DOMRect;
+    /**
+     * 获取元素计算后的样式
+     ** width:仅内容占据的宽度（不含边框和填充）
+     ** height:仅内容占据的高度（不含边框和填充）
+     */
+    getStyle(target: HTMLElement): CSSStyleDeclaration;
+    /**
+     * 提示元素
+     */
+    tooltipElement: HTMLElement;
+    /**
+     * 悬停提示
+     */
+    tooltip(event: MouseEvent, target: HTMLElement): void;
+    /**
+     * 获取数组，含DOMCollection转换后的数组
+     */
+    private getArray;
+    /**
+     * 释放全局唯一性资源
+     */
+    dispose(): void;
+}

package/esm/driver/util/implement/EventUtil.d.ts

@@ -0,0 +1,31 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 事件帮助类
+ */
+export declare class EventUtil extends BaseUtil {
+    type: string;
+    /**
+     * 批量绑定事件，执行指定处理函数
+     */
+    bind: (events: any[], dom: any, fn: Function) => void;
+    /**
+     * 批量绑定事件，执行指定处理函数
+     */
+    unbind: (events: any[], dom: any, fn: Function) => void;
+    /**
+     * 绑定点击处理函数
+     */
+    click: (dom: any, fn: Function) => void;
+    /**
+     * 解除点击监听
+     */
+    unclick: (dom: any, fn: Function) => void;
+    /**
+     * 绑定滚动处理函数
+     */
+    scroll: (dom: any, fn: Function) => void;
+    /**
+     * 移除滚动处理函数，防止内存泄漏
+     */
+    unscroll: (dom: any, fn: Function) => void;
+}

package/esm/driver/util/implement/FileUtil.d.ts

@@ -0,0 +1,23 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 文件帮助类
+ */
+export declare class FileUtil extends BaseUtil {
+    type: string;
+    /**
+     * 保存文件
+     */
+    save: (base64: string, fileName: string) => void;
+    /**
+     * 获取文件扩展名
+     */
+    getExtension: (name: string) => string;
+    /**
+     * 判断当前文件名是否是excel文件
+     */
+    isExcel: (name: string) => boolean;
+    /**
+     * 判断当前文件是否是图片文件
+     */
+    isImage: (url: string) => boolean;
+}

package/esm/driver/util/implement/HtmlUtil.d.ts

@@ -0,0 +1,15 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * Html帮助类
+ */
+export declare class HtmlUtil extends BaseUtil {
+    type: string;
+    /**
+     * 获取Html内容
+     */
+    getHtml: (value: string) => string;
+    /**
+     * 获取Html中的文字
+     */
+    getText: (value: string) => string;
+}

package/esm/driver/util/implement/ImageUtil.d.ts

@@ -0,0 +1,11 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 图片帮助类
+ */
+export declare class ImageUtil extends BaseUtil {
+    type: string;
+    /**
+     * 获取base64图片地址
+     */
+    base64: (base64: string) => string;
+}

package/esm/driver/util/implement/JsonUtil.d.ts

@@ -0,0 +1,62 @@
+import { JsonConfig, Ref, TreeNodeProp } from "../@type";
+import { BaseUtil } from "../BaseUtil";
+/**
+ * JSON帮助类
+ */
+export declare class JsonUtil extends BaseUtil {
+    type: string;
+    /**
+     * 对非字符串进行序列化，默认不美化以节省内存占用
+     */
+    serializeWithoutString(value: any, beautify?: boolean): string;
+    /**
+     * 把对象格式化为Json字符串
+     */
+    serialize(value: any, config?: boolean | JsonConfig): string;
+    /**
+     * 自动移除注释，并反序列化
+     * 支持自动去除// 和 \/**\/注释
+     */
+    autoDeserialize(value: string): any;
+    /**
+     * 反序列化为json对象，异常返回null
+     */
+    deserialize(value: string): any;
+    /**
+     * 尝试反序列化成json对象
+     * 异常时，结果返回异常消息对象
+     */
+    tryDeserialize(value: string, ref: Ref<any>): boolean;
+    /**
+     * 判断指定值，是否包含key
+     */
+    hasKey(value: any, props: string | string[]): boolean;
+    /**
+     * 根据props中的.自动分割得到属性值
+     */
+    getValue(value: any, props: string | string[]): any;
+    /**
+     * 获取所有key集合
+     */
+    getKeys: (props: string | string[]) => string[];
+    /**
+     * 把json字符串合并到目标对象上
+     */
+    mergeTo(target: any, from: string): void;
+    /**
+     * 从树集合构建出Json对象
+     */
+    buildObject(tree: any[], childProp: string, fn: (node: any) => TreeNodeProp): string;
+    /**
+     * 从开始层级开始构建Json字符串
+     */
+    private buildObjectLevel;
+    /**
+     * 填充指定长度的字符串
+     */
+    private fillSpace;
+    /**
+     * 填充指定长度的字符串
+     */
+    private fillKey;
+}

package/esm/driver/util/implement/MathUtil.d.ts

@@ -0,0 +1,70 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 数学帮助类
+ */
+export declare class MathUtil extends BaseUtil {
+    type: string;
+    collator: Intl.Collator;
+    /**
+     * 过滤某一页数据
+     */
+    filterPage: (rows: any[], page: number, size?: number) => any[];
+    /**
+     * 总页数
+     */
+    pageCount: (count: number, size: number) => number;
+    /**
+     * 四舍五入
+     */
+    round: (value: number, digits: number) => string;
+    /**
+     * 天花板函数
+     */
+    ceil: (value: number) => number;
+    /**
+     * 地板取整
+     */
+    floor(value: number): number;
+    /**
+     * 获取最小值
+     */
+    min(...values: number[]): number;
+    /**
+     * 获取最大值
+     */
+    max(...values: number[]): number;
+    /**
+     * 生成指定范围内的随机数
+     */
+    random(start: number, end: number): number;
+    /**
+     * 获取在指定范围内的值
+     ** 自动识别最小和最大值
+     */
+    between(value: number, start: number, end: number): number;
+    /**
+     * 比较两个值的大小
+     ** 1: a大 0:相等 -1: b大
+     */
+    compare(x: any, y: any): number;
+    /**
+     * 转换成可比较的数字 或 原文本
+     */
+    getNumber(value: any): any;
+    /**
+     * 求和，并避免返回NaN
+     */
+    plus<T>(...values: T[]): number;
+    /**
+     * 获取百分比
+     */
+    getPercentage: (handled: number, total: number) => number;
+    /**
+     * 获取百分比，保留2位小数
+     */
+    getPercentageText: (handled: number, total: number) => string;
+    /**
+     * 获取大小
+     */
+    size: (bytes: number) => string;
+}

package/esm/driver/util/implement/MicroUtil.d.ts

@@ -0,0 +1,11 @@
+import { BaseUtil } from "../BaseUtil";
+/**
+ * 微前端帮助类
+ */
+export declare class MicroUtil extends BaseUtil {
+    type: string;
+    /**
+     * 加载乾坤子应用
+     */
+    load: (name: any, entry: any, dom: any, props: any) => void;
+}