ph-utils 0.2.0 → 0.2.3

package/README.md

@@ -4,8 +4,8 @@
 
 ### 后端(node server)
 
-包含了一些 node 后端开发(web server) 时常用的工具类，包括 `index` 基础工具类(这个类里面的函数同样也适用于前端)、`date` 跟日期相关的工具类、`file` 文件操作相关工具类、`server` 一些只适用于后端的工具(使用了后端的 API 列表)
+包含了一些 node 后端开发(web server) 时常用的工具类，包括 `index` 基础工具类(这个类里面的函数同样也适用于前端)、`date` 跟日期相关的工具类、`file` 文件操作相关工具类、`server` 一些只适用于后端的工具(使用了后端的 API 列表)、`validator` 数据验证
 
 ### 前端(web)
 
-包含了一些前端网站开发时常用的工具类，包括 `index` 基础工具类(这个类里面的函数同样也适用于前端)、`date` 跟日期相关的工具类、`dom` 浏览器节点操作相关、`web` 一些只适用于前端相关的工具 s
+包含了一些前端网站开发时常用的工具类，包括 `index` 基础工具类(这个类里面的函数同样也适用于前端)、`date` 跟日期相关的工具类、`dom` 浏览器节点操作相关、`web` 一些只适用于前端相关的工具、`validator` 数据验证

package/lib/date.js

@@ -100,10 +100,10 @@ function startOf(date, unit, isEnd = false) {
 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 - 秒
+ * @param date  指定的日期
+ * @param num   需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit  需要添加的单位，date - 加减天数
+ * @param fmt   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
  * @returns {Date | string} 如果传递了 fmt 参数，则返回 string，否则返回 Date
  */
 function add(date, num, unit, fmt) {

package/lib/dom.d.ts

@@ -2,7 +2,7 @@
  * 根据选择器获取节点
  * @param {string} selector 选择器
  */
-export declare function elem(selector: string, dom?: HTMLElement): NodeListOf<HTMLElement>;
+export declare function elem(selector: string | HTMLElement, dom?: HTMLElement): NodeListOf<HTMLElement> | HTMLElement[];
 /**
  * 为节点添加 class
  * @param {HTMLElement} elem 待添加 class 的节点
@@ -15,6 +15,13 @@ export declare function addClass(elem: HTMLElement, clazz: string): void;
  * @param {string} clazz     需要移除的 class
  */
 export declare function removeClass(elem: HTMLElement, clazz: string): void;
+/**
+ * 判断节点是否包含某个 class
+ * @param elem  待判断 class 的节点
+ * @param clazz 待判断的 class
+ * @returns
+ */
+export declare function hasClass(elem: HTMLElement, clazz: string): boolean;
 /**
  * 为节点添加 transition 属性，包括浏览器前缀
  * @param {HTMLElement} element 需要添加 css Transition 属性的节点
@@ -32,7 +39,7 @@ export declare function transform(element: HTMLElement, value: string): void;
  * @param {HTMLElement} element   添加事件的节点
  * @param {string}      listener  事件名称
  * @param {function}    event     事件处理函数
- * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件；eventStop 表明是否在点击了事件节点时触发，默认为 false
+ * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
 export declare function on(element: HTMLElement, listener: string, fn: (e: Event, target?: HTMLElement, flag?: string) => void, once?: boolean | {
     once?: boolean;
@@ -58,7 +65,7 @@ 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;
+export declare function iterate(elems: NodeList | HTMLElement[], fn: (el: HTMLElement, index: number) => any): void;
 /**
  * 设置或获取节点 data-* 属性
  * @param elem
@@ -67,3 +74,9 @@ export declare function iterate(elems: NodeList, fn: (el: HTMLElement, index: nu
  * @returns
  */
 export declare function attr(elem: HTMLElement, key: string, value?: string): string;
+/**
+ * 获取指定节点的父节点
+ * @param el
+ * @returns
+ */
+export declare function parent(el: HTMLElement): HTMLElement;

package/lib/dom.js

@@ -9,7 +9,12 @@ const vendorPrefix = ['', '-webkit', '-moz-'];
  * @param {string} selector 选择器
  */
 export function elem(selector, dom) {
-    return (dom || document).querySelectorAll(selector);
+    if (typeof selector === 'string') {
+        return (dom || document).querySelectorAll(selector);
+    }
+    else {
+        return [selector];
+    }
 }
 /**
  * 为节点添加 class
@@ -27,6 +32,15 @@ export function addClass(elem, clazz) {
 export function removeClass(elem, clazz) {
     elem.classList.remove(clazz);
 }
+/**
+ * 判断节点是否包含某个 class
+ * @param elem  待判断 class 的节点
+ * @param clazz 待判断的 class
+ * @returns
+ */
+export function hasClass(elem, clazz) {
+    return elem.classList.contains(clazz);
+}
 /**
  * 为节点添加 transition 属性，包括浏览器前缀
  * @param {HTMLElement} element 需要添加 css Transition 属性的节点
@@ -142,3 +156,11 @@ export function attr(elem, key, value) {
         return elem.getAttribute('data-' + key);
     }
 }
+/**
+ * 获取指定节点的父节点
+ * @param el
+ * @returns
+ */
+export function parent(el) {
+    return el.parentNode;
+}

package/lib/index_m.js

@@ -36,7 +36,7 @@ export function shieldMobile(mobile) {
  * @returns true 是数字, false 不是数字
  */
 export function isNumeric(str, numericParam) {
-    numericParam = Object.assign({ isPositive: false, isFloat: true }, (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);

package/lib/server.js

@@ -59,7 +59,7 @@ module.exports = {
             options = { ...(options || {}) };
             const errorName = options.errorName || 'ExecError';
             delete options.errorName;
-            child_process_1.exec(cmd, options, (error, stdout, stderr) => {
+            (0, child_process_1.exec)(cmd, options, (error, stdout, stderr) => {
                 let err = null;
                 let rs = null;
                 if (error) {

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.0",
+  "version": "0.2.3",
   "repository": {
     "type": "git",
     "url": "git+https//gitee.com/towardly/ph.git",
@@ -18,8 +18,8 @@
   },
   "homepage": "https://gitee.com/towardly/ph/tree/master/packages/utils",
   "devDependencies": {
-    "@types/node": "^15.0.3",
-    "typescript": "^4.4.4"
+    "@types/node": "^17.0.21",
+    "typescript": "^4.5.5"
   },
   "scripts": {
     "build": "node scripts/build.js"

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2021 Tenny
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.