halo-fe 1.0.22 → 1.0.24

package/esm/drivers/helpers/HelperFactory.d.ts

@@ -0,0 +1,32 @@
+import { Factory } from "../../factorying";
+import IHelper from "./IHelper";
+import { ArrayHelper, BrowserHelper, ComponentHelper, DictionaryHelper, DomHelper, EventHelper, FileHelper, HtmlHelper, ImageHelper, JsonHelper, MathHelper, MicroHelper, MountHelper, ObjectHelper, ScrollHelper, SignHelper, StringHelper, TaskHelper, TimeHelper, TreeHelper, TypeHelper, UrlHelper } from "./";
+/**
+ * 帮助类工厂
+ */
+declare class HelperFactory extends Factory<IHelper> {
+    open(): void;
+    get array(): ArrayHelper;
+    get browser(): BrowserHelper;
+    get component(): ComponentHelper;
+    get dom(): DomHelper;
+    get dictionary(): DictionaryHelper;
+    get event(): EventHelper;
+    get file(): FileHelper;
+    get html(): HtmlHelper;
+    get image(): ImageHelper;
+    get json(): JsonHelper;
+    get math(): MathHelper;
+    get mount(): MountHelper;
+    get object(): ObjectHelper;
+    get micro(): MicroHelper;
+    get scroll(): ScrollHelper;
+    get string(): StringHelper;
+    get task(): TaskHelper;
+    get type(): TypeHelper;
+    get time(): TimeHelper;
+    get tree(): TreeHelper;
+    get url(): UrlHelper;
+    get sign(): SignHelper;
+}
+export default HelperFactory;

package/esm/drivers/helpers/IHelper.d.ts

@@ -0,0 +1,4 @@
+import { IDriver } from "../@types";
+interface IHelper extends IDriver {
+}
+export default IHelper;

package/esm/drivers/helpers/implements/ArrayHelper.d.ts

@@ -0,0 +1,123 @@
+import Helper from "../Helper";
+/**
+ * 数组帮助类
+ */
+declare class ArrayHelper extends Helper {
+    type: string;
+    /**
+     * 获取指定数组分成每片指定长度后的集合
+     */
+    getChunks: (entities: any[], size: number) => any[][];
+    /**
+     * 获取分成指定片数量后的集合
+     */
+    getChunksByCount(entities: any[], count: number): any[][];
+    /**
+     * 获取指定开始位置的指定数量的集合
+     */
+    getRange(entities: any[], index: number, count?: number): any[];
+    /**
+     * 获取最后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: (entities: any[], func: Function) => any;
+    /**
+     * 求最小值，数据类型的比较函数要自己转换为数值类型
+     */
+    min: (entities: any[], func: Function) => any;
+    /**
+     * 求平均值
+     */
+    avg: (entities: any[], func: Function, digits?: number) => number;
+    /**
+     * 求和
+     */
+    sum: (entities: any[], func: Function, digits?: number) => number;
+    /**
+     * 是否包含
+     */
+    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: (entities: any[], selector: Function) => 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: (...args: any[]) => any[];
+    /**
+     * 在指定元素前插入新元素，返回插入元素的索引
+     */
+    insert: (entities: object[], selectedRow: object, row: object) => number;
+    /**
+     * 在指定元素后插入新元素，返回插入元素的索引
+     */
+    append: (entities: object[], selectedRow: object, row: object) => number;
+    /**
+     * 不存在某元素时才添加某元素
+     */
+    pushIfNotExist: (entities: any[], element: any) => void;
+    /**
+     * 把集合创建成另一个集合
+     */
+    create<T>(entities: any[], handler: (entity: any, i: number) => T): T[];
+    /**
+     * 删除执行数组中的指定对象或者集合
+     */
+    remove: (entities: any[], elements: any[] | any) => void;
+    /**
+     * 删除指定元素，并返回删除后的字符串
+     */
+    removeIndex: (str: string, index: number, split: string) => string;
+    /**
+     * 按照指定函数对数组排序
+     */
+    orderBy: (entities: any[], orderByFns: Function | Function[], order?: "asc" | "desc" | null) => any[];
+    /**
+     * 分组，封装成字典而不是集合，大数据场景速度提升百倍
+     */
+    groupBy: (entities: any[], keyHandler: (entity: any) => any, valueHandler?: (item: any[]) => any) => object;
+    /**
+     * 分组
+     */
+    groupByArray: (entities: any[], keyFunc: (item: any) => any) => any[];
+    /**
+     * 替换指定元素为新元素
+     */
+    replace(entities: any[], selectFn: (value: any) => boolean, replacement: any): void;
+}
+export default ArrayHelper;

package/esm/drivers/helpers/implements/BrowserHelper.d.ts

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

package/esm/drivers/helpers/implements/ComponentHelper.d.ts

@@ -0,0 +1,20 @@
+import Helper from "../Helper";
+/**
+ * 组件帮助类
+ */
+declare class ComponentHelper extends Helper {
+    type: string;
+    /**
+     * 根据动态加载的组件对象，得到组件集合
+     */
+    getComponents(components: object, replace: string, prefix?: string): object;
+    /**
+     * 获取部分自定义组件名称
+     */
+    getName: (url: string, prefix: string) => string;
+    /**
+     * 检测异步控件是否加载完毕
+     */
+    detectLoaded(ref: any, cb: Function): void;
+}
+export default ComponentHelper;

package/esm/drivers/helpers/implements/DictionaryHelper.d.ts

@@ -0,0 +1,40 @@
+import Helper from "../Helper";
+/**
+ * 字典帮助类
+ */
+declare class DictionaryHelper extends Helper {
+    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;
+}
+export default DictionaryHelper;

package/esm/drivers/helpers/implements/DomHelper.d.ts

@@ -0,0 +1,118 @@
+import { Position } from "../../utilities";
+import Helper from "../Helper";
+/**
+ * Dom帮助类
+ */
+declare class DomHelper extends Helper {
+    type: string;
+    /**
+     * 根据字符串Ascii码得到固定颜色字典
+     */
+    getColors(values: string[]): object;
+    /**
+     * 获取样式名
+     */
+    getClass(...args: any[]): string;
+    /**
+     * 添加类
+     */
+    addClass: (dom: Element, cls: string, choice?: any) => void;
+    /**
+     * 删除类
+     */
+    removeClass: (selector: string | Element, className: string, except?: Element) => void;
+    /**
+     * 根据计算后的样式进行DOM过滤
+     */
+    filterStyle(doms: HTMLElement[], fn: (style: CSSStyleDeclaration) => boolean): HTMLElement[];
+    /**
+     * 添加样式
+     */
+    addStyle(dom: HTMLElement, prop: string, value: string): void;
+    /**
+     * 查找兄弟节点
+     */
+    siblings(dom: HTMLElement): HTMLElement[];
+    /**
+     * 查找指定父节点
+     */
+    parentUntil(dom: HTMLElement, cls: string): HTMLElement;
+    /**
+     * 查找第一个绝对定位的元素或backdrop元素，否则使用html元素
+     */
+    parentAbsolute(dom: HTMLElement): HTMLElement;
+    /**
+     * 查找孩子节点
+     */
+    find(dom: Element, cls: string): Element;
+    /**
+     * 获取dom宽度或高度
+     */
+    private getWidthOrHeight;
+    /**
+     * 统计所有控件宽度，含外边距
+     */
+    getWidth(value: Element | Element[]): number;
+    /**
+     * 获取元素可用宽度（移除内填充）
+     */
+    getAvailableWidth(value: Element | Element[]): number;
+    /**
+     * 统计所有非固定定位控件高度，含内填充和外边距
+     */
+    getHeight(value: Element | Element[]): number;
+    /**
+     * 获取元素可用高度（移除内填充）
+     */
+    getAvailableHeight(value: Element | Element[]): number;
+    /**
+     * 获取指定元素在视口内的位置
+     */
+    getViewportStyle(target: Element, title: string, subMenu: string, viewport: Element, position: string): any;
+    /**
+     * 获取指定选择器最大的索引
+     */
+    getMaxIndex(selector: string): 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;
+    /**
+     * 获取文本宽度
+     */
+    getTextWidth(value: string): number;
+    /**
+     * 判断选择器内容是否溢出
+     */
+    isEllipsis: (selector: string) => boolean;
+}
+export default DomHelper;

package/esm/drivers/helpers/implements/EventHelper.d.ts

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

package/esm/drivers/helpers/implements/FileHelper.d.ts

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

package/esm/drivers/helpers/implements/HtmlHelper.d.ts

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

package/esm/drivers/helpers/implements/ImageHelper.d.ts

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

package/esm/drivers/helpers/implements/JsonHelper.d.ts

@@ -0,0 +1,49 @@
+import { JsonConfig, TreeNodeProp } from "../@types";
+import Helper from "../Helper";
+/**
+ * JSON帮助类
+ */
+declare class JsonHelper extends Helper {
+    type: string;
+    /**
+     * 对非字符串进行序列化
+     */
+    serializeWithoutString(value: any): string;
+    /**
+     * 把对象格式化为Json字符串
+     */
+    serialize(value: any, config?: boolean | JsonConfig): string;
+    /**
+     * 反序列化成json对象
+     */
+    deserialize(value: string): any;
+    /**
+     * 根据props中的.自动分割得到属性值
+     */
+    hasKey(value: any, props: string[]): boolean;
+    /**
+     * 根据props中的.自动分割得到属性值
+     */
+    getValue(value: any, props: string[]): any;
+    /**
+     * 把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;
+}
+export default JsonHelper;

package/esm/drivers/helpers/implements/MathHelper.d.ts

@@ -0,0 +1,52 @@
+import Helper from "../Helper";
+/**
+ * 数学帮助类
+ */
+declare class MathHelper extends Helper {
+    type: string;
+    /**
+     * 过滤某一页数据
+     */
+    filterPage: (rows: any[], page: number, size: number) => any[];
+    /**
+     * 总页数
+     */
+    pageCount: (count: number, size: number) => number;
+    /**
+     * 四舍五入
+     */
+    round: (value: number, digits: number) => string;
+    /**
+     * 天花板函数
+     */
+    ceil: (value: number) => number;
+    /**
+     * 获取最大值
+     */
+    max(...values: number[]): number;
+    /**
+     * 生成指定范围内的随机数
+     */
+    random(start: number, end: number): number;
+    /**
+     * 获取在指定范围内的值
+     */
+    between(value: number, min: number, max: number): number;
+    /**
+     * 尝试把任意类型转成数字，转换不成功返回原值
+     */
+    getNumber(value: any): any;
+    /**
+     * 获取百分比
+     */
+    getPercentage: (handled: number, total: number) => number;
+    /**
+     * 获取百分比，保留2位小数
+     */
+    getPercentageText: (handled: number, total: number) => string;
+    /**
+     * 获取大小
+     */
+    size: (bytes: number) => string;
+}
+export default MathHelper;

package/esm/drivers/helpers/implements/MicroHelper.d.ts

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

package/esm/drivers/helpers/implements/MountHelper.d.ts

@@ -0,0 +1,16 @@
+import Helper from "../Helper";
+/**
+ * 事件挂载帮助类
+ */
+declare class MountHelper extends Helper {
+    type: string;
+    /**
+     * 激发主框架事件
+     */
+    emit: (event: string, payload: any) => void;
+    /**
+     * 批量激发主框架事件
+     */
+    emits: (events: any) => void;
+}
+export default MountHelper;

package/esm/drivers/helpers/implements/ObjectHelper.d.ts

@@ -0,0 +1,44 @@
+import Helper from "../Helper";
+/**
+ * 对象帮助类
+ */
+declare class ObjectHelper extends Helper {
+    type: string;
+    /**
+     * 净化对象，返回不带默认属性的对象
+     */
+    pure(input: object): {};
+    /**
+     * 过滤key，并输出新对象
+     */
+    filter(input: object, filter: (n: any) => boolean, valueFn: (n: any) => {}): any[];
+    /**
+     * 提取部分属性，并得到新对象
+     */
+    extract(value: object, keys: string[]): any;
+    /**
+     * 把数组转换成对象
+     */
+    toObject(array: any[], keyFn: (n: any) => string, valueFn: (n: any) => string): any;
+    /**
+     * 手动复制，并对字段执行指定自定义处理
+     */
+    copy: (obj: any, handler?: {}) => any[] | any;
+    /**
+     * 对对象进行深度克隆，同时可以移除Proxy对象
+     */
+    clone<T>(obj: T, handler?: (n: any) => void): T;
+    /**
+     * 合并来源对象到目标对象上
+     */
+    mergeTo(target: any, from: any): any;
+    /**
+     * 给对象添加多层属性，并赋值
+     */
+    addProperties: (obj: object, keys: string[], value: string) => void;
+    /**
+     * 获取对象不区分大小写的key
+     */
+    getKey(value: object, key: string): string;
+}
+export default ObjectHelper;

package/esm/drivers/helpers/implements/ScrollHelper.d.ts

@@ -0,0 +1,16 @@
+import Helper from "../Helper";
+/**
+ * 滚动帮助类
+ */
+declare class ScrollHelper extends Helper {
+    type: string;
+    /**
+     * 判断指定元素滚动条位置，是否到了页面底部
+     */
+    isBottom: (selector: any) => boolean;
+    /**
+     * 滚动指定元素的滚动条到页面底部
+     */
+    scrollToBottom: (selector: any) => void;
+}
+export default ScrollHelper;

package/esm/drivers/helpers/implements/SignHelper.d.ts

@@ -0,0 +1,16 @@
+import Helper from "../Helper";
+/**
+ * 签名帮助类
+ */
+declare class SignHelper extends Helper {
+    type: string;
+    /**
+     * 清空对象中的空值
+     */
+    clean(obj: object): void;
+    /**
+     * 签名字典
+     */
+    signDictionary(dictionary: object, encoding?: boolean): string;
+}
+export default SignHelper;