ph-utils 0.0.13 → 0.1.4

package/lib/date.d.ts

@@ -17,3 +17,18 @@ export declare function parse(date?: Date | string | number): Date;
  * @param {Boolean} isEnd true则为 endOf
  */
 export declare function startOf(date?: Date | string | number, unit?: string, isEnd?: boolean): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date 指定的日期
+ * @param num  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit 需要添加的单位，date - 加减天数
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date    指定的日期, 传递为 null ，则表示为当前日期
+ * @param num     需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit    需要添加的单位，date - 加减天数
+ * @param fmt     如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string, fmt: string): string;

package/lib/date.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startOf = exports.parse = exports.format = void 0;
+exports.add = exports.startOf = exports.parse = exports.format = void 0;
 /**
  * node 和 web 端日期处理工具类
  */
@@ -21,6 +21,9 @@ function p(s, l = 2) {
      */
     return ('000' + s).slice(l * -1);
 }
+function getUnit(unit) {
+    return unit.substring(0, 1).toUpperCase() + unit.substring(1);
+}
 /**
  * 将日期格式化为指定形式的字符串
  * @param date      日期
@@ -88,9 +91,36 @@ function startOf(date, unit, isEnd = false) {
     const argumentStart = [0, 0, 0, 0];
     const argumentEnd = [23, 59, 59, 999];
     date = parse(date);
-    let fn = 'set' + unit || 'Hours';
+    let u = getUnit(unit || 'Hours');
+    let fn = 'set' + u;
     let args = isEnd === true ? argumentEnd : argumentStart;
     Date.prototype[fn].apply(date, args);
     return date;
 }
 exports.startOf = startOf;
+/**
+ * 日期加上指定时间后的日期
+ * @param date {Date | number | string | null}  指定的日期
+ * @param num {number}  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit {string}  需要添加的单位，date - 加减天数
+ * @param fmt {string}   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ * @returns {Date | string} 如果传递了 fmt 参数，则返回 string，否则返回 Date
+ */
+function add(date, num, unit, fmt) {
+    let sdate = new Date();
+    if (date != null) {
+        sdate = parse(date);
+    }
+    unit = getUnit(unit);
+    let fn = 'set' + unit;
+    let gn = 'get' + unit;
+    let oldValue = Date.prototype[gn].apply(sdate);
+    Date.prototype[fn].apply(sdate, [oldValue + num]);
+    if (typeof fmt === 'string') {
+        return format(sdate, fmt);
+    }
+    else {
+        return sdate;
+    }
+}
+exports.add = add;

package/lib/date_m.d.ts

@@ -17,3 +17,18 @@ export declare function parse(date?: Date | string | number): Date;
  * @param {Boolean} isEnd true则为 endOf
  */
 export declare function startOf(date?: Date | string | number, unit?: string, isEnd?: boolean): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date 指定的日期
+ * @param num  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit 需要添加的单位，date - 加减天数
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date    指定的日期, 传递为 null ，则表示为当前日期
+ * @param num     需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit    需要添加的单位，date - 加减天数
+ * @param fmt     如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string, fmt: string): string;

package/lib/date_m.js

@@ -18,6 +18,9 @@ function p(s, l = 2) {
      */
     return ('000' + s).slice(l * -1);
 }
+function getUnit(unit) {
+    return unit.substring(0, 1).toUpperCase() + unit.substring(1);
+}
 /**
  * 将日期格式化为指定形式的字符串
  * @param date      日期
@@ -83,8 +86,34 @@ export function startOf(date, unit, isEnd = false) {
     const argumentStart = [0, 0, 0, 0];
     const argumentEnd = [23, 59, 59, 999];
     date = parse(date);
-    let fn = 'set' + unit || 'Hours';
+    let u = getUnit(unit || 'Hours');
+    let fn = 'set' + u;
     let args = isEnd === true ? argumentEnd : argumentStart;
     Date.prototype[fn].apply(date, args);
     return date;
 }
+/**
+ * 日期加上指定时间后的日期
+ * @param date  指定的日期
+ * @param num   需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit  需要添加的单位，date - 加减天数
+ * @param fmt   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ * @returns {Date | string} 如果传递了 fmt 参数，则返回 string，否则返回 Date
+ */
+export function add(date, num, unit, fmt) {
+    let sdate = new Date();
+    if (date != null) {
+        sdate = parse(date);
+    }
+    unit = getUnit(unit);
+    let fn = 'set' + unit;
+    let gn = 'get' + unit;
+    let oldValue = Date.prototype[gn].apply(sdate);
+    Date.prototype[fn].apply(sdate, [oldValue + num]);
+    if (typeof fmt === 'string') {
+        return format(sdate, fmt);
+    }
+    else {
+        return sdate;
+    }
+}

package/lib/dom.d.ts

@@ -32,6 +32,37 @@ export declare function transform(element: HTMLElement, value: string): void;
  * @param {HTMLElement} element   添加事件的节点
  * @param {string}      listener  事件名称
  * @param {function}    event     事件处理函数
- * @param {boolean}     once      是否是只运行一次的处理函数
+ * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
-export declare function on(element: HTMLElement, listener: string, event: (e?: Event) => void, once?: boolean): void;
+export declare function on(element: HTMLElement, listener: string, fn: (e: Event, target?: HTMLElement, flag?: string) => void, once?: boolean | {
+    once?: boolean;
+    eventFlag?: string;
+}): void;
+/**
+ * 设置或获取节点的 innerHTML 属性
+ * @param element
+ * @param htmlstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export declare function html(element: HTMLElement, htmlstr?: string): string;
+/**
+ * 设置或获取节点的 textContent 属性
+ * @param element
+ * @param textstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export declare function text(element: HTMLElement, textstr?: string): string;
+/**
+ * 节点列表遍历
+ * @param elems
+ * @param fn 遍历到节点时的回调，回调第一个参数为遍历到的节点，第2个参数为 index；如果回调函数返回 true，则会终止遍历(break)
+ */
+export declare function iterate(elems: NodeList, fn: (el: HTMLElement, index: number) => any): void;
+/**
+ * 设置或获取节点 data-* 属性
+ * @param elem
+ * @param key data- 后面跟随的值
+ * @param value 如果传递该值表示获取；否则表示设置
+ * @returns
+ */
+export declare function attr(elem: HTMLElement, key: string, value?: string): string;

package/lib/dom.js

@@ -54,8 +54,90 @@ export function transform(element, value) {
  * @param {HTMLElement} element   添加事件的节点
  * @param {string}      listener  事件名称
  * @param {function}    event     事件处理函数
- * @param {boolean}     once      是否是只运行一次的处理函数
+ * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
-export function on(element, listener, event, once = false) {
-    element.addEventListener(listener, event, { once });
+export function on(element, listener, fn, once = false) {
+    let eventExtra = {};
+    if (typeof once === 'boolean') {
+        eventExtra.once = true;
+    }
+    else {
+        eventExtra = once;
+    }
+    if (eventExtra.eventFlag !== null) {
+        element.addEventListener(listener, (e) => {
+            let target = e.target;
+            let flag = '';
+            do {
+                flag = target.getAttribute(eventExtra.eventFlag) || '';
+                if (flag === '') {
+                    target = target.parentNode;
+                }
+            } while (flag === '');
+            if (flag !== '__stop__') {
+                fn(e, target, flag);
+            }
+        }, eventExtra);
+    }
+    else {
+        element.addEventListener(listener, fn, eventExtra);
+    }
+}
+/**
+ * 设置或获取节点的 innerHTML 属性
+ * @param element
+ * @param htmlstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export function html(element, htmlstr) {
+    if (htmlstr == null) {
+        return element.innerHTML;
+    }
+    else {
+        element.innerHTML = htmlstr;
+        return undefined;
+    }
+}
+/**
+ * 设置或获取节点的 textContent 属性
+ * @param element
+ * @param textstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export function text(element, textstr) {
+    if (textstr == null) {
+        return element.textContent;
+    }
+    else {
+        element.textContent = textstr;
+        return undefined;
+    }
+}
+/**
+ * 节点列表遍历
+ * @param elems
+ * @param fn 遍历到节点时的回调，回调第一个参数为遍历到的节点，第2个参数为 index；如果回调函数返回 true，则会终止遍历(break)
+ */
+export function iterate(elems, fn) {
+    for (let i = 0, len = elems.length; i < len; i++) {
+        let r = fn(elems[i], i);
+        if (r === true) {
+            break;
+        }
+    }
+}
+/**
+ * 设置或获取节点 data-* 属性
+ * @param elem
+ * @param key data- 后面跟随的值
+ * @param value 如果传递该值表示获取；否则表示设置
+ * @returns
+ */
+export function attr(elem, key, value) {
+    if (value != null) {
+        elem.setAttribute('data-' + key, value);
+    }
+    else {
+        return elem.getAttribute('data-' + key);
+    }
 }

package/lib/index.js

@@ -1,23 +1,27 @@
+"use strict";
 /**
  * node 和 web 通用的工具类
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+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,24 +40,31 @@ 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 {
+class BaseError extends Error {
+    /**
+     * 错误名称，类似于 Java 中的不同的 Exception[NullPointerException]；
+     * 增加 name 字段，表明不同的错误，当需要根据不同的错误执行不同的处理的时候，会很有用
+     */
+    name;
     constructor() {
         if (arguments.length === 1) {
             super(arguments[0]);
@@ -64,3 +76,4 @@ export class BaseError extends Error {
         }
     }
 }
+exports.BaseError = BaseError;

package/lib/web.d.ts

@@ -8,11 +8,10 @@ interface QueryRes {
 }
 /**
  * 获取 url query 参数 (get 请求的参数)
- * @param key 获取指定 key 的参数，可选，如果不传该参数，则返回解析到的所有的参数列表
  * @param search 如果是 React 应用就需要传递 useLocation().search
  * @returns
  */
-export declare function query(key?: string | string[], search?: string): QueryRes;
+export declare function query(search?: string): QueryRes;
 interface RandomOpts {
     /** 生成的随机数是整形还是小数形 */
     isInt?: boolean;

package/lib/web.js

@@ -30,11 +30,10 @@ export const formJson = function (form) {
 };
 /**
  * 获取 url query 参数 (get 请求的参数)
- * @param key 获取指定 key 的参数，可选，如果不传该参数，则返回解析到的所有的参数列表
  * @param search 如果是 React 应用就需要传递 useLocation().search
  * @returns
  */
-export function query(key, search) {
+export function query(search) {
     if (isBlank(search)) {
         search = location.search;
     }

package/package.json

@@ -5,7 +5,7 @@
   "module": "lib/index_m.js",
   "types": "lib/index.d.ts",
   "browser": "lib/index_m.js",
-  "version": "0.0.13",
+  "version": "0.1.4",
   "repository": {
     "type": "git",
     "url": "git+https//gitee.com/towardly/ph.git",
@@ -19,7 +19,7 @@
   "homepage": "https://gitee.com/towardly/ph/tree/master/packages/utils",
   "devDependencies": {
     "@types/node": "^15.0.3",
-    "typescript": "^4.2.4"
+    "typescript": "^4.4.4"
   },
   "scripts": {
     "build": "node scripts/build.js"