ph-utils 0.2.10 → 0.2.13

package/lib/dom.d.ts

@@ -80,3 +80,13 @@ export declare function attr(elem: HTMLElement, key: string, value?: string): st
  * @returns
  */
 export declare function parent(el: HTMLElement): HTMLElement;
+/**
+ * 获取隐藏节点的尺寸
+ * @param {string | HTMLElement} hideNode - The node to hide.
+ * @param parent - 添加临时节点的父节点，默认为: body.
+ * @returns The DOMRect of the element.
+ */
+export declare function queryHideNodeSize(hideNode: string | HTMLElement, parent?: HTMLElement): {
+    width: number;
+    height: number;
+};

package/lib/dom.js

@@ -164,3 +164,27 @@ export function attr(elem, key, value) {
 export function parent(el) {
     return el.parentNode;
 }
+/**
+ * 获取隐藏节点的尺寸
+ * @param {string | HTMLElement} hideNode - The node to hide.
+ * @param parent - 添加临时节点的父节点，默认为: body.
+ * @returns The DOMRect of the element.
+ */
+export function queryHideNodeSize(hideNode, parent = document.body) {
+    // 计算折叠菜单的高度
+    let $tmp = document.createElement('div');
+    $tmp.style.cssText = 'position:fixed;left:-1000px;top:-1000px;opacity:0;';
+    let $tmpInner = document.createElement('div');
+    $tmpInner.style.cssText = 'position:relative;';
+    if (typeof hideNode === 'string') {
+        $tmpInner.innerHTML = hideNode;
+    }
+    else {
+        $tmpInner.appendChild(hideNode.cloneNode(true));
+    }
+    $tmp.appendChild($tmpInner);
+    parent.appendChild($tmp);
+    let rect = $tmpInner.children[0].getBoundingClientRect();
+    parent.removeChild($tmp);
+    return { width: rect.width, height: rect.height };
+}

package/lib/index.d.ts

@@ -50,5 +50,12 @@ export declare class BaseError extends Error {
      * @param name 错误名称
      * @param message 错误描述
      */
-    constructor(name: String, message: string);
+    constructor(name: string, message: string);
 }
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+export declare function throttle<T extends (...args: any) => any>(func: T, wait?: number): (...args: any[]) => void;

package/lib/index.js

@@ -1,23 +1,27 @@
+"use strict";
 /**
  * node 和 web 通用的工具类
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throttle = exports.BaseError = exports.isBoolean = exports.isNumeric = exports.shieldMobile = exports.isBlank = void 0;
 /**
  * 验证字符串是否为空
  * @param str               待验证的字符串
  * @param ignoreWhitespace  是否忽略空格(包括空白字符串以及[\r\t\n]之类的制表符)，默认为true
  */
-export function isBlank(str, ignoreWhitespace = true) {
+function isBlank(str, ignoreWhitespace = true) {
     if (str == null) {
         return true;
     }
     return (ignoreWhitespace ? str.trim().length : str.length) === 0;
 }
+exports.isBlank = isBlank;
 /**
  * 屏蔽手机号，中间部分用 * 展示
  * @param mobile 待屏蔽的手机号
  * @returns 屏蔽后的手机号，例如：123 **** 1234
  */
-export function shieldMobile(mobile) {
+function shieldMobile(mobile) {
     let x1 = Math.round(mobile.length / 2);
     let x2 = Math.round(x1 / 2);
     let shields = [' '];
@@ -27,6 +31,7 @@ export function shieldMobile(mobile) {
     shields.push(' ');
     return mobile.substring(0, x2) + shields.join('') + mobile.substring(x2 + x1);
 }
+exports.shieldMobile = shieldMobile;
 /**
  * 验证参数是否是数字
  * @param str 待验证的字符串
@@ -35,36 +40,26 @@ export function shieldMobile(mobile) {
  * @param numericParam.isFloat 是否是小数
  * @returns true 是数字, false 不是数字
  */
-export function isNumeric(str, numericParam) {
+function isNumeric(str, numericParam) {
     numericParam = { isPositive: false, isFloat: true, ...(numericParam || {}) };
     let symbol = numericParam.isPositive ? '[+]?' : '[+-]?';
     let main = numericParam.isFloat ? '([0-9]*[.])?[0-9]+' : '[0-9]+';
     return new RegExp('^' + symbol + main + '$').test(str);
 }
+exports.isNumeric = isNumeric;
 /**
  * 验证参数是否是Boolean 类型
  * @param str 待验证的字符串
  * @returns
  */
-export function isBoolean(str) {
+function isBoolean(str) {
     return ['true', 'false'].indexOf(str) >= 0;
 }
+exports.isBoolean = isBoolean;
 /**
  * 带有错误名称标记的错误类型
  */
-export class BaseError extends Error {
-    constructor() {
-        if (arguments.length === 1) {
-            super(arguments[0]);
-            this.name = 'BaseError';
-        }
-        else {
-            super(arguments[1]);
-            this.name = arguments[0];
-        }
-    }
-}
-ass BaseError extends Error {
+class BaseError extends Error {
     /**
      * 错误名称，类似于 Java 中的不同的 Exception[NullPointerException]；
      * 增加 name 字段，表明不同的错误，当需要根据不同的错误执行不同的处理的时候，会很有用
@@ -82,3 +77,20 @@ ass BaseError extends Error {
     }
 }
 exports.BaseError = BaseError;
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+function throttle(func, wait = 300) {
+    let t = -1;
+    return function (...args) {
+        const self = this;
+        clearTimeout(t);
+        t = setTimeout(() => {
+            func.apply(self, args);
+        }, wait);
+    };
+}
+exports.throttle = throttle;

package/lib/index_m.d.ts

@@ -50,5 +50,12 @@ export declare class BaseError extends Error {
      * @param name 错误名称
      * @param message 错误描述
      */
-    constructor(name: String, message: string);
+    constructor(name: string, message: string);
 }
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+export declare function throttle<T extends (...args: any) => any>(func: T, wait?: number): (...args: any[]) => void;

package/lib/index_m.js

@@ -64,3 +64,19 @@ export class BaseError extends Error {
         }
     }
 }
+/**
+ * 创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。
+ * @param func 要节流的函数
+ * @param wait 需要节流的毫秒
+ * @returns
+ */
+export function throttle(func, wait = 300) {
+    let t = -1;
+    return function (...args) {
+        const self = this;
+        clearTimeout(t);
+        t = setTimeout(() => {
+            func.apply(self, args);
+        }, wait);
+    };
+}

package/package.json

@@ -5,7 +5,7 @@
   "module": "lib/index_m.js",
   "types": "lib/index.d.ts",
   "browser": "lib/index_m.js",
-  "version": "0.2.10",
+  "version": "0.2.13",
   "repository": {
     "type": "git",
     "url": "git+https//gitee.com/towardly/ph.git",