jinbi-utils 1.0.20 → 1.0.21

package/src/date/index.ts

@@ -0,0 +1,143 @@
+/**
+ * 时间处理相关
+ * @packageDocumentation
+ * @module Date
+ * @preferred
+ */
+import { isEmpty } from '../common';
+
+/**
+ * 解决ios不支持 new Date('2020-02-02')问题
+ #### 使用说明
+ ```
+  compatibleDate('2020-03-04') 返回 2020/03/04
+  compatibleDate(Date.now()) 返回 Date.now()
+  compatibleDate(new Date()) 返回 new Date()
+  ```
+ */
+export function compatibleDate(date: string | number | Date) {
+  if (typeof date === 'string') {
+    return date.replace(/-/g, '/');
+  }
+  return date;
+}
+
+/**
+ * 调用原生 new Date 返回 Date实例 解决ios不支持 yyyy-MM-dd HH:mm:ss 格式new Date
+ #### 使用说明
+ ```
+  newDate() 返回 new Date()
+  newDate('2020-03-04') 返回 new Date('2020-03-04')
+  ```
+ */
+export function newDate(date?: string | number | Date): Date {
+  if (!date) return new Date();
+  return new Date(compatibleDate(date));
+}
+
+/**
+ * 格式化时间
+ #### 使用说明
+ ```
+ formatTime() 返回 yyyy-MM-dd HH:mm:ss 格式的当前时间
+ formatTime('2018-02-02 00:00:00') 返回 2018-02-02 00:00:00
+ formatTime('2018-02-02', 'yyyy/MM/dd') 返回 2018/02/02
+ formatTime('2018-02-02 23:50:50', 'yyyy/MM/dd HH:mm:ss') 返回 2018/02/02 23:50:50
+ formatTime('2018-02-02 23:50:50', 'MM/dd HH:mm:ss') 返回 02/02 23:50:50
+ formatTime(new Date('2018-02-02 23:50:50') + 200, 'yyyy/MM/dd HH:mm:ss S') 返回 2018/02/02 23:50:50 200
+ ```
+ */
+export function formatTime(date: string | number | Date = Date.now(), fmt = 'yyyy-MM-dd HH:mm:ss') {
+  date = compatibleDate(date);
+
+  date = new Date(date);
+  const o: any = {
+    'M+': date.getMonth() + 1, // 月份
+    'd+': date.getDate(), // 日
+    'h+': date.getHours() % 12 === 0 ? 12 : date.getHours() % 12, // 小时
+    'H+': date.getHours(), // 小时
+    'm+': date.getMinutes(), // 分
+    's+': date.getSeconds(), // 秒
+    'q+': Math.floor((date.getMonth() + 3) / 3), // 季度
+    S: date.getMilliseconds(), // 毫秒
+  };
+
+  if (/(y+)/.test(fmt)) {
+    fmt = fmt.replace(RegExp.$1, (`${date.getFullYear()}`).substr(4 - RegExp.$1.length));
+  }
+
+  Object.keys(o).forEach((k) => {
+    if (new RegExp(`(${k})`).test(fmt)) {
+      fmt = fmt.replace(RegExp.$1, (RegExp.$1.length === 1) ? (o[k]) : ((`00${o[k]}`).substr((`${o[k]}`).length)));
+    }
+  });
+
+  return fmt;
+}
+
+/**
+ * 格式化相对时间
+ #### 使用说明
+ ```
+ fromNow('') 返回 -
+ fromNow(Date.now() - 2000) 返回 刚刚
+ fromNow(now - 3420 * 1000) 返回 58分钟前面
+ fromNow(now - 3600 * 1000 * 3) 返回 3小时前
+ fromNow(now - 3600 * 1000 * 24 * 1.5) 返回 1天前
+ fromNow(now - day5) 返回 当前时间的5天前日期 格式 yyyy年MM月dd日 HH时mm分ss秒
+ fromNow(Date.now() + 2000) 返回 Date.now() + 2000
+ fromNow('', '', 'defaultValue') 等于 defaultValue
+ ```
+ */
+export function fromNow(time: Date | string | number, fmt: string = 'yyyy年MM月dd日 HH时mm分ss秒', defaultValue = '-') {
+  if (isEmpty(time)) {
+    return defaultValue;
+  }
+  time = compatibleDate(time);
+  const d = new Date(time);
+  const now = Date.now();
+  const diff = (now - d.getTime()) / 1000;
+  if (diff < 0) {
+    return time;
+  }
+
+  if (diff < 30) {
+    return '刚刚';
+  }
+  if (diff < 3600) {
+    return `${Math.ceil(diff / 60)}分钟前`;
+  }
+  if (diff < 3600 * 24) {
+    return `${Math.floor(diff / 3600)}小时前`;
+  }
+  if (diff < 3600 * 24 * 2) {
+    return '1天前';
+  }
+
+  return formatTime(time, fmt);
+}
+
+/**
+ * 增加日期天数
+ #### 使用说明
+ ```
+ addDays('') 返回 -
+ addDays('2018-02-02') 返回 2018-02-02
+ addDays('2018-02-02', 2) 返回 2018-02-04
+ addDays('2018-02-02', 2, 'yyyy/MM/dd') 返回 2018/02/04
+ addDays(new Date('2020-03-04'), 2, 'yyyy/MM/dd') 返回 2020/03/06
+ addDays(Date.now(), 2, 'yyyy/MM/dd') 返回 今天 + 2天
+ ```
+ */
+export function addDays(date: Date | string | number, days: string | number = 0, fmt: string = 'yyyy-MM-dd') {
+  if (isEmpty(date)) {
+    return '-';
+  }
+  date = compatibleDate(date);
+  const d = new Date(date);
+  d.setDate(d.getDate() + Number(days));
+
+  return formatTime(d, fmt);
+}
+
+// 获取当前时间月份

package/src/dom/index.ts

@@ -0,0 +1,198 @@
+/**
+ * DOM 操作相关
+ * @packageDocumentation
+ * @module DOM
+ * @preferred
+ */
+
+/**
+ * 检查元素是否包含指定的 class
+ * @param el - DOM 元素
+ * @param cls - class 名称
+ * @returns 是否包含该 class
+ */
+export function hasClass(el: Element | null, cls: string): boolean {
+  if (typeof window === 'undefined' || !el) return false;
+  return !!el.className.match(new RegExp('(\\s|^)' + cls + '(\\s|$)'));
+}
+
+/**
+ * 添加 class 到元素
+ * @param el - DOM 元素
+ * @param cls - class 名称
+ */
+export function addClass(el: Element | null, cls: string): void {
+  if (typeof window === 'undefined' || !el) return;
+  if (!hasClass(el, cls)) {
+    el.className += ' ' + cls;
+  }
+}
+
+/**
+ * 从元素移除 class
+ * @param el - DOM 元素
+ * @param cls - class 名称
+ */
+export function removeClass(el: Element | null, cls: string): void {
+  if (typeof window === 'undefined' || !el) return;
+  if (hasClass(el, cls)) {
+    const reg = new RegExp('(\\s|^)' + cls + '(\\s|$)');
+    el.className = el.className.replace(reg, ' ').trim();
+  }
+}
+
+/**
+ * 切换元素的 class
+ * @param flag - 是否添加 class
+ * @param clsName - class 名称
+ * @param target - 目标元素，默认为 document.body
+ */
+export function toggleClass(
+  flag: boolean,
+  clsName: string,
+  target?: HTMLElement
+): void {
+  if (typeof window === 'undefined') return;
+
+  const targetEl = target || document.body;
+  let { className } = targetEl;
+  className = className.replace(clsName, '').trim();
+  targetEl.className = flag ? `${className} ${clsName}`.trim() : className;
+}
+
+/**
+ * 打开链接
+ * @param url - URL 地址
+ * @param target - 打开方式，默认 "_blank"
+ */
+export function openLink(url: string, target: string = '_blank'): void {
+  if (typeof window === 'undefined') return;
+
+  const link = document.createElement('a');
+  link.setAttribute('href', url);
+  link.setAttribute('target', target);
+  link.setAttribute('rel', 'noreferrer noopener');
+  link.setAttribute('id', 'external');
+
+  const existingLink = document.getElementById('external');
+  if (existingLink) {
+    document.body.removeChild(existingLink);
+  }
+
+  document.body.appendChild(link);
+  link.click();
+  link.remove();
+}
+
+/**
+ * 复制文本到剪贴板
+ * @param text - 要复制的文本
+ * @returns 是否复制成功
+ */
+export function copyTextToClipboard(text: string): boolean {
+  if (typeof window === 'undefined' || typeof document === 'undefined') {
+    return false;
+  }
+
+  // 创建临时文本框
+  const textarea = document.createElement('textarea');
+  const activeElement = document.activeElement as HTMLElement;
+
+  textarea.value = text;
+  textarea.setAttribute('readonly', '');
+  textarea.style.position = 'absolute';
+  textarea.style.left = '-9999px';
+  textarea.style.fontSize = '12pt';
+  textarea.style.border = '0';
+  textarea.style.padding = '0';
+  textarea.style.margin = '0';
+
+  // 保存当前选区
+  const selection = document.getSelection();
+  let originalRange: Range | null = null;
+  if (selection && selection.rangeCount > 0) {
+    originalRange = selection.getRangeAt(0);
+  }
+
+  // 添加到 DOM 并选中
+  document.body.appendChild(textarea);
+  textarea.select();
+  textarea.selectionStart = 0;
+  textarea.selectionEnd = text.length;
+
+  // 执行复制
+  let success = false;
+  try {
+    success = document.execCommand('copy');
+  } catch (err) {
+    console.error('复制失败:', err);
+  }
+
+  // 清理
+  textarea.remove();
+
+  // 恢复原选区
+  if (originalRange && selection) {
+    selection.removeAllRanges();
+    selection.addRange(originalRange);
+  }
+
+  // 恢复焦点
+  if (activeElement) {
+    activeElement.focus();
+  }
+
+  return success;
+}
+
+/**
+ * SVG 信息接口
+ */
+export interface SvgInfo {
+  width: number;
+  height: number;
+  body: string;
+}
+
+/**
+ * 解析 SVG 字符串，提取宽度、高度和 body 内容
+ * @param svg - SVG 字符串
+ * @returns SVG 信息对象或原字符串
+ */
+export function getSvgInfo(svg: string): SvgInfo | string {
+  if (typeof window === 'undefined' || typeof DOMParser === 'undefined') {
+    return svg;
+  }
+
+  try {
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(svg, 'image/svg+xml');
+    const svgElement = doc.querySelector('svg');
+
+    if (!svgElement) {
+      return svg;
+    }
+
+    const viewBox = svgElement.getAttribute('viewBox');
+    if (!viewBox) {
+      throw new Error('Invalid SVG string: Missing viewBox attribute.');
+    }
+
+    const viewBoxParts = viewBox.split(' ');
+    const width = parseInt(viewBoxParts[2], 10);
+    const height = parseInt(viewBoxParts[3], 10);
+
+    const paths = Array.from(svgElement.querySelectorAll('path'));
+    const body = paths.map(path => path.outerHTML).join(' ');
+
+    return {
+      width,
+      height,
+      body,
+    };
+  } catch (error) {
+    console.error('解析 SVG 失败:', error);
+    return svg;
+  }
+}
+

package/src/file/index.ts

@@ -0,0 +1,319 @@
+/**
+ * 文件处理相关
+ * @packageDocumentation
+ * @module File
+ * @preferred
+ */
+
+import { isEmpty } from '../common';
+import { ceil } from '../number';
+
+export type FileSizeUnit =  'B' |'KB' | 'MB' | 'GB' | 'TB';
+
+export interface FileSizeObject {
+  size: number;
+  unit: FileSizeUnit;
+}
+/**
+ * 计算文件大小
+ #### 使用说明
+ ```
+ calcFileSize(100) 返回 { size: 100, unit: 'B' }
+ calcFileSize(1024) 返回 { size: 1, unit: 'KB' }
+ calcFileSize(1024, 'KB') 返回 { size: 1, unit: 'MB' }
+ calcFileSize(1126.4, 'mb') 返回 { size: 1.1, unit: 'GB' }
+ calcFileSize(Math.pow(1024, 2), 'kb') 返回 { size: 1, unit: 'GB' }
+ ```
+ * @param size 单位 k
+ * @returns number
+ */
+export function calcFileSize(size: number, unit: FileSizeUnit = 'B'): FileSizeObject {
+  const unitList: Array<FileSizeUnit> = ['B', 'KB', 'MB', 'GB', 'TB'];
+
+  let currentUnitIndex = unitList.indexOf(unit.toUpperCase() as FileSizeUnit);
+
+  currentUnitIndex = currentUnitIndex === -1 ? 0 : currentUnitIndex;
+
+  // todo 单位换算。
+  while (size >= 1024 && currentUnitIndex < unitList.length) {
+    size = size / 1024;
+    currentUnitIndex += 1;
+  }
+  return {
+    size,
+    unit: unitList[currentUnitIndex],
+  };
+}
+
+/**
+ * 文件大小转换
+ #### 使用说明
+ ```
+ fileSizeFormat('') 返回 -
+ fileSizeFormat('1024') 返回 1KB
+ fileSizeFormat('1024', 'KB') 返回 1MB
+ fileSizeFormat('2645', 'B') 返回 ceil(2645 / 1024, 2)MB
+ ```
+ * @param {string} str 字符串 单位k
+ */
+export function fileSizeFormat(str: string | number, unit: FileSizeUnit = 'B', defaultValue = '-') {
+  if (isEmpty(str)) {
+    return defaultValue;
+  }
+  const o = calcFileSize(parseFloat(str.toString()), unit);
+  return `${ceil(o.size, 2)}${o.unit}`;
+}
+
+/**
+ * base64转换为file
+ * dataurl base64图片
+ * */
+export function dataURLtoBlob(dataurl: string): Blob {
+  const mime = (dataurl.match(/:(.*?);/) as any)[1];
+  const bytes = window.atob(dataurl.split(',')[1]); // 去掉url的头，并转换为byte
+  // 处理异常,将ascii码小于0的转换为大于0
+  const ab = new ArrayBuffer(bytes.length);
+  const ia = new Uint8Array(ab);
+  for (let i = 0; i < bytes.length; i += 1) {
+    ia[i] = bytes.charCodeAt(i);
+  }
+  return new Blob([ab], { type: mime });
+}
+
+export function blobToDataURL(blob: Blob): any {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = (e) => {
+      if (!e || !e.target) {
+        reject(e);
+      } else {
+        resolve(e.target.result as string);
+      }
+    };
+    reader.onerror = (err) => {
+      reject(err);
+    };
+    reader.readAsDataURL(blob);
+  });
+}
+
+export interface CompressImgScaleCallback {
+  (w: number, h: number): number;
+}
+export interface CompressImgQualityCallback {
+  (fileSize: number, scale: number, w: number, h: number): number;
+}
+
+/**
+ * 压缩图片方法
+ * @param file 图片
+ * @param scaleCallback 宽高 压缩规则
+ * @param qualityCallback 质量 压缩规则
+ */
+export function compressImg(
+  file: File,
+  scaleCallback?: CompressImgScaleCallback,
+  qualityCallback?: CompressImgQualityCallback,
+): Promise<Blob> {
+  return new Promise((resolve, reject) => {
+    const fileSize = parseFloat((file.size / 1024 / 1024).toString());
+    const read = new FileReader();
+    read.onload = (e: ProgressEvent<FileReader>) => {
+      const img = new Image();
+      img.onload = () => {
+        // 读取图片宽高
+        const w = img.width;
+        const h = img.height;
+        // 生成canvas
+        const canvas = document.createElement('canvas');
+        const ctx = canvas.getContext('2d');
+
+        // 处理函数返回的不是 number & NaN 类型的情况
+        let scale = scaleCallback ? scaleCallback(w, h) : 1;
+        if (Number.isNaN(scale) || typeof scale !== 'number') {
+          scale = 1;
+        }
+        let quality = qualityCallback ? qualityCallback(fileSize, scale, w, h) : 1;
+        if (Number.isNaN(quality) || typeof quality !== 'number') {
+          quality = 1;
+        }
+
+        // 图片 缩放规则
+        if (ctx) {
+          const scaleW = parseInt((w * scale).toString(), 10);
+          const scaleH = parseInt((h * scale).toString(), 10);
+          // 创建属性节点
+          canvas.setAttribute('width', scaleW.toString());
+          canvas.setAttribute('height', scaleH.toString());
+          ctx.drawImage(img, 0, 0, scaleW, scaleH);
+        }
+        // 图片质量 压缩
+        const base64 = canvas.toDataURL(file.type, quality);
+
+        resolve(dataURLtoBlob(base64));
+      };
+      img.onerror = (evt: Event | string) => {
+        reject(evt);
+      };
+
+      if (e.target) {
+        img.src = e.target.result as string;
+      }
+    };
+
+    read.onerror = (e: ProgressEvent<FileReader>) => {
+      reject(e);
+    };
+    read.readAsDataURL(file);
+  });
+}
+
+export type Method =
+  | 'get' | 'GET'
+  | 'delete' | 'DELETE'
+  | 'head' | 'HEAD'
+  | 'options' | 'OPTIONS'
+  | 'post' | 'POST'
+  | 'put' | 'PUT'
+  | 'patch' | 'PATCH'
+  | 'link' | 'LINK'
+  | 'unlink' | 'UNLINK'
+
+export interface ExportByBlobParams {
+  /**
+   * 请求方式
+   */
+  method?: Method;
+  /**
+   * 接口地址
+   */
+  url: string;
+  /**
+   * post接口参数
+   */
+  data?: any;
+  /**
+   * get接口参数
+   */
+  params?: any;
+   /**
+   * 导出的文件名称
+   */
+  filename?: string;
+}
+
+
+export interface GenExportByBlobParams {
+/**
+ * axios 请求函数
+ */
+axiosRequest: any;
+/**
+ * 不使用 withCredentials 域名
+ */
+  notWithCredentials?: string[];
+}
+/**
+ * 生成导出函数
+ */
+export function genExportByBlob({
+  axiosRequest,
+  notWithCredentials = [],
+}) {
+  return function exportByBlob(config: ExportByBlobParams) {
+    let {
+      filename,
+    } = config;
+    const {
+      url,
+      data = {},
+      params = {},
+      method = 'post',
+     } = config;
+    return new Promise((resolve, reject) => {
+      axiosRequest({
+        method,
+        url,
+        data,
+        params,
+        responseType: 'blob',
+        config: {
+          withCredentials: notWithCredentials.some((str) => {
+            return !url.includes(str);
+          }),
+        },
+        // eslint-disable-next-line consistent-return
+      }).then(async (res) => {
+        const response = res?.data;
+        if (response.type === 'application/json') {
+          const reader = new FileReader();
+          reader.readAsText(response, 'utf-8');
+          reader.onload = () => {
+            let result: any = {};
+            try {
+              result = JSON.parse(reader.result as string);
+            } catch (e) {
+              result = response;
+            }
+            // Message.error((result && result.message) || '导出失败');
+            reject(result);
+          };
+        } else {
+          try {
+            const { headers } = res; // 下载后文件名
+            const contentDisposition = headers['content-disposition'];
+            const responseFilename = decodeURIComponent(contentDisposition.split(';')[1].split('filename=')[1]);
+            // 有传文件名称&不带后缀 使用服务端的文件拓展名
+            if (filename && !filename.includes('.')) {
+              const splitFileName = responseFilename.split('.');
+              const suffix = splitFileName[splitFileName.length - 1];
+              filename += `.${suffix}`;
+            } else if (!filename) {
+              filename = responseFilename;
+            }
+          } catch (e) {
+            // 默认名称
+            if (!filename) {
+              filename = 'download.xlsx';
+            }
+          }
+          const blob = new Blob([res.data]);
+          const downloadElement = document.createElement('a');
+          const href = await blobToDataURL(blob); // 创建下载的链接
+          downloadElement.href = href;
+          downloadElement.download = filename;
+          document.body.appendChild(downloadElement);
+          downloadElement.click(); // 点击下载
+          document.body.removeChild(downloadElement); // 下载完成移除元素
+          // window.URL.revokeObjectURL(href);
+          resolve(res);
+        }
+      }).catch((e: Error) => {
+        reject(e);
+      });
+    });
+  };
+}
+/**
+ * 将 base64 字符串转换为 File 或 Blob
+ * @param {string} base64 - 带有 data URI 的 base64 字符串
+ * @param {string} [filename] - 如果提供了，则返回 File；否则返回 Blob
+ * @returns {File|Blob}
+ */
+export async function base64ToFileOrBlob(base64, filename) {
+  const [meta, content] = base64.split(',')
+  const mime = meta.match(/:(.*?);/)[1]
+  const bstr = atob(content)
+  const len = bstr.length
+  const u8arr = new Uint8Array(len)
+
+  for (let i = 0; i < len; i++) {
+    u8arr[i] = bstr.charCodeAt(i)
+  }
+
+  if (filename) {
+    return new File([u8arr], filename, { type: mime })
+  } else {
+    return new Blob([u8arr], { type: mime })
+  }
+}