ele-admin-plus 1.3.1-beta.1 → 1.4.0

package/es/utils/common.d.ts

@@ -0,0 +1,82 @@
+import { Mutable, SlotObject } from '../ele-app/types';
+
+export * from './core';
+/**
+ * 防抖函数
+ * @param func 函数
+ * @param wait 等待时间
+ */
+export declare function debounce<T extends (...args: any) => any>(func: T, wait: number): (this: any) => void;
+/**
+ * 节流函数
+ * @param func 函数
+ * @param wait 等待时间
+ * @param trailing 是否在节流结束后调用
+ */
+export declare function throttle<T extends (...args: any) => any>(func: T, wait: number, trailing?: boolean): (this: any) => void;
+/**
+ * 忽略对象属性
+ * @param obj 来源对象
+ * @param fields 忽略的属性
+ */
+export declare function omit<T extends {}, K extends keyof T>(obj: T | null | undefined, fields: K[]): Mutable<Omit<T, K>>;
+/**
+ * 摘选对象属性
+ * @param obj 来源对象
+ * @param fields 摘选的属性
+ */
+export declare function pick<T extends object, K extends keyof T>(obj: T, fields: K[]): Mutable<Pick<T, K>>;
+/**
+ * 根据字段路径获取值
+ * @param data 数据
+ * @param path 字段路径
+ * @param defaultValue 默认值
+ */
+export declare function getValue<T, K>(data?: K | null, path?: string | string[] | ((d: K) => T), defaultValue?: T): T | undefined;
+/**
+ * 首字母大写
+ * @param str 字符串
+ */
+export declare function capitalize(str: string): string;
+/**
+ * 获取映射后的插槽
+ * @param slots 插槽
+ * @param slotsMap 插槽映射
+ * @param excludes 排除的插槽映射
+ * @param excludeSlots 排除的插槽
+ * @param reserveSlots 是否保留所有的插槽
+ */
+export declare function getMappedSlots(slots: SlotObject, slotsMap?: Record<string, string>, excludes?: string[], excludeSlots?: string[], reserveSlots?: boolean): SlotObject;
+/**
+ * 获取可用的插槽映射
+ * @param slots 插槽
+ * @param slotsMap 插槽映射
+ * @param excludes 排除的插槽映射
+ * @param excludeSlots 排除的插槽
+ * @param reserveSlots 是否保留所有的插槽
+ */
+export declare function getSlotsMap(slots: SlotObject, slotsMap?: Record<string, string>, excludes?: string[], excludeSlots?: string[], reserveSlots?: boolean): Record<string, string>;
+/**
+ * 获取节点样式
+ * @param el 节点
+ */
+export declare function getCurrentStyle(el: Element): CSSStyleDeclaration;
+/**
+ * 判断元素内容是否溢出省略
+ * @param el 元素节点
+ * @param direction 只判断单个方向是否溢出
+ */
+export declare function contentIsEllipsis(el: HTMLElement, direction?: 'horizontal' | 'vertical'): boolean;
+/**
+ * 下载文件
+ * @param url 文件地址
+ * @param name 文件名
+ */
+export declare function downloadUrl(url: string, name: string): void;
+/**
+ * 下载文件
+ * @param data 二进制数据
+ * @param name 文件名
+ * @param type 文件类型
+ */
+export declare function download(data: Blob | ArrayBuffer | string, name: string, type?: string): void;

package/es/utils/common.js

@@ -0,0 +1,162 @@
+export * from "./core";
+function debounce(func, wait) {
+  let timer = void 0;
+  const debounced = function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      func.apply(this, args);
+      timer = void 0;
+    }, wait);
+  };
+  return debounced;
+}
+function throttle(func, wait, trailing) {
+  let timer = void 0;
+  const debounced = function(...args) {
+    if (!timer) {
+      if (!trailing) {
+        func.apply(this, args);
+      }
+      timer = setTimeout(() => {
+        if (trailing) {
+          func.apply(this, args);
+        }
+        timer = void 0;
+      }, wait);
+    }
+  };
+  return debounced;
+}
+function omit(obj, fields) {
+  const result = Object.assign({}, obj);
+  if (obj) {
+    for (const key of fields) {
+      delete result[key];
+    }
+  }
+  return result;
+}
+function pick(obj, fields) {
+  const result = {};
+  if (obj) {
+    for (const key of fields) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+function getValue(data, path, defaultValue) {
+  if (data == null) {
+    return defaultValue;
+  }
+  const pathType = typeof path;
+  if (pathType === "function") {
+    return path(data);
+  }
+  const fields = (pathType === "string" ? path.match(/[^\[\].]+/g) : path) ?? [];
+  let result = data;
+  for (const key of fields) {
+    result = result[key.trim()];
+  }
+  return typeof result === "undefined" ? defaultValue : result;
+}
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function getMappedSlots(slots, slotsMap, excludes, excludeSlots, reserveSlots) {
+  const resultSlots = {};
+  const userSlots = slotsMap || {};
+  Object.keys(userSlots).forEach((name) => {
+    const slotName = userSlots[name];
+    if (!(excludes || []).includes(name) && slotName && !(excludeSlots || []).includes(slotName)) {
+      resultSlots[name] = slots[slotName];
+    }
+  });
+  if (reserveSlots) {
+    Object.keys(slots).forEach((name) => {
+      if (!resultSlots[name] && !(excludeSlots || []).includes(name)) {
+        resultSlots[name] = slots[name];
+      }
+    });
+  }
+  return resultSlots;
+}
+function getSlotsMap(slots, slotsMap, excludes, excludeSlots, reserveSlots) {
+  const resultMap = {};
+  const userSlots = slotsMap || {};
+  Object.keys(userSlots).forEach((name) => {
+    const slotName = userSlots[name];
+    if (!(excludes || []).includes(name) && slotName && !(excludeSlots || []).includes(slotName)) {
+      resultMap[name] = slotName;
+    }
+  });
+  if (reserveSlots) {
+    Object.keys(slots).forEach((name) => {
+      if (!resultMap[name] && !(excludeSlots || []).includes(name)) {
+        resultMap[name] = name;
+      }
+    });
+  }
+  return resultMap;
+}
+function getCurrentStyle(el) {
+  return el["currentStyle"] || window.getComputedStyle(el, null) || {};
+}
+function contentIsEllipsis(el, direction) {
+  if (!el || !el.childNodes.length) {
+    return false;
+  }
+  const range = document.createRange();
+  range.setStart(el, 0);
+  range.setEnd(el, el.childNodes.length);
+  const { width, height } = range.getBoundingClientRect();
+  const floorW = Math.floor(width);
+  const rangeWidth = width - floorW < 8e-3 ? floorW : width;
+  const floorH = Math.floor(height);
+  const rangeHeight = height - floorH < 8e-3 ? floorH : height;
+  const style = getCurrentStyle(el);
+  const top = Number.parseInt(style.paddingTop) || 0;
+  const left = Number.parseInt(style.paddingLeft) || 0;
+  const right = Number.parseInt(style.paddingRight) || 0;
+  const bottom = Number.parseInt(style.paddingBottom) || 0;
+  const horizontalPadding = left + right;
+  const verticalPadding = top + bottom;
+  if (direction === "horizontal") {
+    return rangeWidth + horizontalPadding > el.offsetWidth || el.scrollWidth > el.offsetWidth;
+  }
+  if (direction === "vertical") {
+    return rangeHeight + verticalPadding > el.offsetHeight || el.scrollHeight > el.offsetHeight;
+  }
+  return rangeWidth + horizontalPadding > el.offsetWidth || rangeHeight + verticalPadding > el.offsetHeight || el.scrollWidth > el.offsetWidth;
+}
+function downloadUrl(url, name) {
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = name;
+  a.style.display = "none";
+  document.body.appendChild(a);
+  a.click();
+  document.body.removeChild(a);
+}
+function download(data, name, type) {
+  const blob = new Blob([data], { type: type || "application/octet-stream" });
+  const url = URL.createObjectURL(blob);
+  downloadUrl(url, name);
+  URL.revokeObjectURL(url);
+}
+export {
+  capitalize,
+  contentIsEllipsis,
+  debounce,
+  download,
+  downloadUrl,
+  getCurrentStyle,
+  getMappedSlots,
+  getSlotsMap,
+  getValue,
+  omit,
+  pick,
+  throttle
+};

package/es/utils/core.d.ts

@@ -1,5 +1,3 @@
-import { Mutable } from '../ele-app/types';
-
 /**
  * toTree 方法参数
  */
@@ -35,68 +33,22 @@ export declare function toTree<T>(option: ToTreeOption<T>): T[];
  */
 export declare function eachTree<T>(data?: T[], callback?: (item: T, index: number, parent?: T) => void | boolean, childrenField?: string, parent?: T): false | undefined;
 /**
- * 格式化 children 形式数据
+ * 处理 children 形式数据
  * @param data 数据
  * @param formatter 格式器
  * @param childrenField children 字段名
  * @param resultChildrenField 返回后的 children 字段名
+ * @param afterFormatter 后置格式器
  * @param parent 当前的父级
  */
-export declare function mapTree<T, K>(data: T[] | undefined | null, formatter: (item: T, index?: number, parent?: K) => K | void | undefined, childrenField?: string, resultChildrenField?: string, parent?: K): K[];
+export declare function mapTree<T, K>(data: T[] | undefined | null, formatter: (item: T, index?: number, parent?: T | K) => K | void | undefined | 'flatChildren', childrenField?: string, resultChildrenField?: string, afterFormatter?: (item: K) => K | void | undefined, parent?: T | K): K[];
 /**
- * 查找树形数据
+ * 查找 children 形式数据
  * @param data 数据
  * @param predicate 查找条件
  * @param childrenField children 字段名
  */
 export declare function findTree<T>(data: T[] | undefined, predicate: (value: T, index: number) => unknown, childrenField?: string): T | undefined;
-/**
- * 生成 m 到 n 的随机数
- * @param m 最小值(包含)
- * @param n 最大值(不包含)
- */
-export declare function random(m: number, n: number): number;
-/**
- * 生成随机字符串
- * @param length 长度
- * @param radix 基数
- */
-export declare function uuid(length?: number, radix?: number): string;
-/**
- * 数字千分位
- * @param num 数字
- */
-export declare function formatNumber(num?: number | null): string;
-/**
- * 赋值不改变原字段
- * @param target 目标对象
- * @param source 源对象
- * @param excludes 排除的字段
- */
-export declare function assignObject<T extends {}, K extends {}>(target: T, source: K, excludes?: string[]): T;
-/**
- * 判断是否是外链
- * @param url 地址
- */
-export declare function isExternalLink(url?: string | null): boolean;
-/**
- * 查找直接子元素
- * @param parentEl 父元素
- * @param className 类名
- * @param attr 属性
- */
-export declare function queryChild(parentEl?: Element, className?: string, attr?: string[]): Element | undefined;
-/**
- * 获取节点样式
- * @param el 节点
- */
-export declare function getCurrentStyle(el: Element): CSSStyleDeclaration;
-/**
- * 判断元素内容是否溢出省略
- * @param el 元素节点
- * @param direction 只判断单个方向是否溢出
- */
-export declare function contentIsEllipsis(el: HTMLElement, direction?: 'horizontal' | 'vertical'): boolean;
 /**
  * 检查是否全屏
  */
@@ -130,39 +82,43 @@ export declare function bd09ToGcj02(point: Point): Point;
  */
 export declare function gcj02ToBd09(point: Point): Point;
 /**
- * 复制字符串
- * @param text 字符串
+ * 生成 m 到 n 的随机数
+ * @param m 最小值(包含)
+ * @param n 最大值(不包含)
  */
-export declare function copyText(text: string): Promise<undefined>;
+export declare function random(m: number, n: number): number;
 /**
- * 根据字段路径获取值
- * @param data 数据
- * @param path 字段路径
- * @param defaultValue 默认值
+ * 生成随机字符串
+ * @param length 长度
+ * @param radix 基数
+ */
+export declare function uuid(length?: number, radix?: number): string;
+/**
+ * 数字千分位
+ * @param num 数字
  */
-export declare function getValue<T, K>(data?: K | null, path?: string | string[] | ((d: K) => T), defaultValue?: T): T | undefined;
+export declare function formatNumber(num?: number | null): string;
 /**
- * 防抖函数
- * @param func 函数
- * @param wait 等待时间
+ * 赋值不改变原字段
+ * @param target 目标对象
+ * @param source 源对象
+ * @param excludes 排除的字段
  */
-export declare function debounce<T extends (...args: any) => any>(func: T, wait: number): (this: any) => void;
+export declare function assignObject<T extends {}, K extends {}>(target: T, source: K, excludes?: string[]): T;
 /**
- * 节流函数
- * @param func 函数
- * @param wait 等待时间
- * @param trailing 是否在节流结束后调用
+ * 复制字符串
+ * @param text 字符串
  */
-export declare function throttle<T extends (...args: any) => any>(func: T, wait: number, trailing?: boolean): (this: any) => void;
+export declare function copyText(text: string): Promise<undefined>;
 /**
- * 忽略对象属性
- * @param obj 来源对象
- * @param fields 忽略的属性
+ * 查找直接子元素
+ * @param parentEl 父元素
+ * @param className 根据类名查找
+ * @param attr 根据属性查找
  */
-export declare function omit<T extends {}, K extends keyof T>(obj: T | null | undefined, fields: K[]): Mutable<Omit<T, K>>;
+export declare function queryChild(parentEl?: Element, className?: string, attr?: string[]): Element | undefined;
 /**
- * 摘选对象属性
- * @param obj 来源对象
- * @param fields 摘选的属性
+ * 判断是否是外链
+ * @param url 地址
  */
-export declare function pick<T extends object, K extends keyof T>(obj: T, fields: K[]): Mutable<Pick<T, K>>;
+export declare function isExternalLink(url?: string | null): boolean;

package/es/utils/core.js

@@ -70,23 +70,64 @@ function eachTree(data, callback, childrenField = "children", parent) {
     }
   }
 }
-function mapTree(data, formatter, childrenField = "children", resultChildrenField = "children", parent) {
+function formatTreeItem(item, index, parent, formatter, childrenField = "children", resultChildrenField = "children", afterFormatter) {
   const result = [];
-  if (data && data.length) {
+  const itemResult = formatter(item, index, parent);
+  if (itemResult === "flatChildren") {
+    const children = item[childrenField];
+    if (children) {
+      children.forEach((c, j) => {
+        const childItems = formatTreeItem(
+          c,
+          j,
+          item,
+          formatter,
+          childrenField,
+          resultChildrenField,
+          afterFormatter
+        );
+        childItems.forEach((childItem) => {
+          const afterItem = afterFormatter ? afterFormatter(childItem) : childItem;
+          if (afterItem) {
+            result.push(afterItem);
+          }
+        });
+      });
+    }
+  } else if (itemResult) {
+    if (item[childrenField] != null) {
+      itemResult[resultChildrenField] = mapTree(
+        item[childrenField],
+        formatter,
+        childrenField,
+        resultChildrenField,
+        afterFormatter,
+        itemResult
+      );
+    }
+    const afterItem = afterFormatter ? afterFormatter(itemResult) : itemResult;
+    if (afterItem) {
+      result.push(afterItem);
+    }
+  }
+  return result;
+}
+function mapTree(data, formatter, childrenField = "children", resultChildrenField = "children", afterFormatter, parent) {
+  const result = [];
+  if (data) {
     data.forEach((d, i) => {
-      const item = formatter(d, i, parent);
-      if (item) {
-        if (d[childrenField] != null) {
-          item[resultChildrenField] = mapTree(
-            d[childrenField],
-            formatter,
-            childrenField,
-            resultChildrenField,
-            item
-          );
-        }
+      const items = formatTreeItem(
+        d,
+        i,
+        parent,
+        formatter,
+        childrenField,
+        resultChildrenField,
+        afterFormatter
+      );
+      items.forEach((item) => {
         result.push(item);
-      }
+      });
     });
   }
   return result;
@@ -105,75 +146,6 @@ function findTree(data, predicate, childrenField) {
   );
   return temp;
 }
-function random(m, n) {
-  return Math.floor(Math.random() * (m - n) + n);
-}
-function uuid(length = 32, radix) {
-  const str = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-  let result = "";
-  for (let i = 0; i < length; i++) {
-    result += str.charAt(Math.floor(Math.random() * (radix || str.length)));
-  }
-  return result;
-}
-function formatNumber(num) {
-  return String(num ?? "").replace(/(\d{1,3})(?=(\d{3})+(?:$|\.))/g, "$1,");
-}
-function assignObject(target, source, excludes) {
-  Object.keys(target).forEach((key) => {
-    var _a;
-    if (!((_a = excludes == null ? void 0 : excludes.includes) == null ? void 0 : _a.call(excludes, key))) {
-      target[key] = source[key];
-    }
-  });
-  return target;
-}
-function isExternalLink(url) {
-  return !!(url && (url.startsWith("http://") || url.startsWith("https://") || url.startsWith("//")));
-}
-function queryChild(parentEl, className, attr) {
-  return Array.from((parentEl == null ? void 0 : parentEl.children) ?? []).find((el) => {
-    if (className && !el.classList.contains(className)) {
-      return false;
-    }
-    if (attr != null && attr[0] != null) {
-      if (el.getAttribute(attr[0]) != attr[1]) {
-        return false;
-      }
-    }
-    return true;
-  });
-}
-function getCurrentStyle(el) {
-  return el["currentStyle"] || window.getComputedStyle(el, null) || {};
-}
-function contentIsEllipsis(el, direction) {
-  if (!el || !el.childNodes.length) {
-    return false;
-  }
-  const range = document.createRange();
-  range.setStart(el, 0);
-  range.setEnd(el, el.childNodes.length);
-  const { width, height } = range.getBoundingClientRect();
-  const floorW = Math.floor(width);
-  const rangeWidth = width - floorW < 8e-3 ? floorW : width;
-  const floorH = Math.floor(height);
-  const rangeHeight = height - floorH < 8e-3 ? floorH : height;
-  const style = getCurrentStyle(el);
-  const top = Number.parseInt(style.paddingTop) || 0;
-  const left = Number.parseInt(style.paddingLeft) || 0;
-  const right = Number.parseInt(style.paddingRight) || 0;
-  const bottom = Number.parseInt(style.paddingBottom) || 0;
-  const horizontalPadding = left + right;
-  const verticalPadding = top + bottom;
-  if (direction === "horizontal") {
-    return rangeWidth + horizontalPadding > el.offsetWidth || el.scrollWidth > el.offsetWidth;
-  }
-  if (direction === "vertical") {
-    return rangeHeight + verticalPadding > el.offsetHeight || el.scrollHeight > el.offsetHeight;
-  }
-  return rangeWidth + horizontalPadding > el.offsetWidth || rangeHeight + verticalPadding > el.offsetHeight || el.scrollWidth > el.offsetWidth;
-}
 function checkFullscreen() {
   return !!(document.fullscreenElement || document.webkitFullscreenElement || document.mozFullScreenElement || document.msFullscreenElement);
 }
@@ -213,6 +185,29 @@ function gcj02ToBd09(point) {
     lat: z * Math.sin(theta) + 6e-3
   };
 }
+function random(m, n) {
+  return Math.floor(Math.random() * (m - n) + n);
+}
+function uuid(length = 32, radix) {
+  const str = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += str.charAt(Math.floor(Math.random() * (radix || str.length)));
+  }
+  return result;
+}
+function formatNumber(num) {
+  return String(num ?? "").replace(/(\d{1,3})(?=(\d{3})+(?:$|\.))/g, "$1,");
+}
+function assignObject(target, source, excludes) {
+  Object.keys(target).forEach((key) => {
+    var _a;
+    if (!((_a = excludes == null ? void 0 : excludes.includes) == null ? void 0 : _a.call(excludes, key))) {
+      target[key] = source[key];
+    }
+  });
+  return target;
+}
 async function copyText(text) {
   var _a;
   if (typeof ((_a = navigator == null ? void 0 : navigator.clipboard) == null ? void 0 : _a.writeText) === "function") {
@@ -235,91 +230,37 @@ async function copyText(text) {
   }
   el.remove();
 }
-function getValue(data, path, defaultValue) {
-  if (data == null) {
-    return defaultValue;
-  }
-  const pathType = typeof path;
-  if (pathType === "function") {
-    return path(data);
-  }
-  const fields = (pathType === "string" ? path.match(/[^\[\].]+/g) : path) ?? [];
-  let result = data;
-  for (const key of fields) {
-    result = result[key.trim()];
-  }
-  return typeof result === "undefined" ? defaultValue : result;
-}
-function debounce(func, wait) {
-  let timer = void 0;
-  const debounced = function(...args) {
-    if (timer) {
-      clearTimeout(timer);
+function queryChild(parentEl, className, attr) {
+  return Array.from((parentEl == null ? void 0 : parentEl.children) ?? []).find((el) => {
+    if (className && !el.classList.contains(className)) {
+      return false;
     }
-    timer = setTimeout(() => {
-      func.apply(this, args);
-      timer = void 0;
-    }, wait);
-  };
-  return debounced;
-}
-function throttle(func, wait, trailing) {
-  let timer = void 0;
-  const debounced = function(...args) {
-    if (!timer) {
-      if (!trailing) {
-        func.apply(this, args);
+    if (attr != null && attr[0] != null) {
+      if (el.getAttribute(attr[0]) != attr[1]) {
+        return false;
       }
-      timer = setTimeout(() => {
-        if (trailing) {
-          func.apply(this, args);
-        }
-        timer = void 0;
-      }, wait);
-    }
-  };
-  return debounced;
-}
-function omit(obj, fields) {
-  const result = Object.assign({}, obj);
-  if (obj) {
-    for (const key of fields) {
-      delete result[key];
     }
-  }
-  return result;
+    return true;
+  });
 }
-function pick(obj, fields) {
-  const result = {};
-  if (obj) {
-    for (const key of fields) {
-      result[key] = obj[key];
-    }
-  }
-  return result;
+function isExternalLink(url) {
+  return !!(url && (url.startsWith("http://") || url.startsWith("https://") || url.startsWith("//")));
 }
 export {
   assignObject,
   bd09ToGcj02,
   checkFullscreen,
-  contentIsEllipsis,
   copyText,
-  debounce,
   eachTree,
   exitFullscreen,
   findTree,
   formatNumber,
   gcj02ToBd09,
-  getCurrentStyle,
-  getValue,
   isExternalLink,
   mapTree,
-  omit,
-  pick,
   queryChild,
   random,
   requestFullscreen,
-  throttle,
   toTree,
   uuid
 };