ph-utils 0.18.0 → 0.20.0

package/lib/dom.d.ts

@@ -10,6 +10,7 @@
 type FormatStyleParam = (string | undefined | null)[] | Record<string, boolean | string | undefined | null> | string;
 type FormatClassParam = (string | undefined | null | boolean)[] | Record<string, boolean | string | undefined | null | boolean> | string;
 type DocumentContext = HTMLElement | ShadowRoot | Document;
+type NodeChildren = HTMLElement | DocumentFragment | HTMLElement[] | NodeListOf<HTMLElement> | HTMLCollection;
 export declare function elem(selector: string | HTMLElement, dom?: DocumentContext): HTMLElement[];
 /**
  * 根据选择器获取 DOM 元素。
@@ -22,7 +23,7 @@ export declare function $(selector: string | HTMLElement, dom?: DocumentContext)
  * 创建一个 HTML 元素，支持通过标签名或 HTML 字符串创建。
  * @param tag - 元素标签名或 HTML 字符串。
  * @param option - 元素的属性、样式、文本内容等配置。所有不是指定的属性，都会通过 setAttribute 设置
- * @param ctx - 元素的父级文档上下文。
+ * @param children - 子节点
  * @returns 创建的 HTML 元素。
  */
 export declare function create(tag: string, option?: {
@@ -32,7 +33,7 @@ export declare function create(tag: string, option?: {
     innerHTML?: string;
     outerHTML?: string;
     [index: string]: any;
-}, ctx?: DocumentContext): HTMLElement;
+}, children?: NodeChildren): HTMLElement;
 /** 创建节点 */
 export declare function $$(tag: string, option?: {
     class?: FormatClassParam;
@@ -41,7 +42,7 @@ export declare function $$(tag: string, option?: {
     innerHTML?: string;
     outerHTML?: string;
     [index: string]: any;
-}, ctx?: DocumentContext): HTMLElement;
+}, children?: NodeChildren): HTMLElement;
 /**
  * 根据选择器获取匹配的第一个 DOM 元素。
  * @param selector - 选择器字符串或直接的 HTMLElement。

package/lib/dom.js

@@ -19,10 +19,10 @@ export function $(selector, dom) {
  * 创建一个 HTML 元素，支持通过标签名或 HTML 字符串创建。
  * @param tag - 元素标签名或 HTML 字符串。
  * @param option - 元素的属性、样式、文本内容等配置。所有不是指定的属性，都会通过 setAttribute 设置
- * @param ctx - 元素的父级文档上下文。
+ * @param children - 子节点
  * @returns 创建的 HTML 元素。
  */
-export function create(tag, option = {}, ctx) {
+export function create(tag, option = {}, children) {
     let $el;
     if (tag.startsWith("<") && tag.endsWith(">")) {
         const parser = new DOMParser();
@@ -53,7 +53,7 @@ export function create(tag, option = {}, ctx) {
                         $el.outerHTML = value;
                     }
                     else {
-                        if (value === true) {
+                        if (typeof value === "boolean" && value === true) {
                             $el.setAttribute(key, "");
                         }
                         else {
@@ -63,15 +63,30 @@ export function create(tag, option = {}, ctx) {
                 }
             }
         }
-        if (ctx) {
-            ctx.appendChild($el);
+        if (children) {
+            if (children instanceof HTMLElement || children instanceof DocumentFragment) {
+                $el.appendChild(children);
+            }
+            else {
+                let len = children.length;
+                const fragment = document.createDocumentFragment();
+                for (let i = 0; i < len; i++) {
+                    const child = children[i];
+                    if (child instanceof HTMLElement) {
+                        fragment.appendChild(child);
+                    }
+                }
+                if (len > 0) {
+                    $el.appendChild(fragment);
+                }
+            }
         }
     }
     return $el;
 }
 /** 创建节点 */
-export function $$(tag, option = {}, ctx) {
-    return create(tag, option, ctx);
+export function $$(tag, option = {}, children) {
+    return create(tag, option, children);
 }
 /**
  * 根据选择器获取匹配的第一个 DOM 元素。

package/lib/validator.d.ts

@@ -24,9 +24,7 @@ export interface SchemaType {
  * 数据验证器
  */
 declare class Validator {
-    rules: {
-        [index: string]: RuleItem[];
-    };
+    rules: Record<string, RuleItem[]>;
     /**
      * 构造数据验证转换器
      *
@@ -47,6 +45,8 @@ declare class Validator {
     constructor(schemas: SchemaType[]);
     addSchemas(schemas: SchemaType[]): void;
     addSchema(schema: SchemaType): void;
+    setSchema(schema: SchemaType): void;
+    setSchemas(schemas: SchemaType[]): void;
     /**
      * 进行数据验证
      * @param data 待验证的数据

package/lib/validator.js

@@ -61,17 +61,28 @@ class Validator {
      * validator.validateKey().then(res => {})
      */
     constructor(schemas) {
-        this.rules = {};
-        this.addSchemas(schemas);
+        this.setSchemas(schemas);
     }
     addSchemas(schemas) {
         for (let schema of schemas) {
-            this.rules[schema.key] = this._parseSchemaRules(schema);
+            this.addSchema(schema);
         }
     }
     addSchema(schema) {
+        if (schema.key in this.rules) {
+            this.rules[schema.key] = [...this.rules[schema.key], ...this._parseSchemaRules(schema)];
+        }
+        else {
+            this.rules[schema.key] = this._parseSchemaRules(schema);
+        }
+    }
+    setSchema(schema) {
         this.rules[schema.key] = this._parseSchemaRules(schema);
     }
+    setSchemas(schemas) {
+        this.rules = {};
+        this.addSchemas(schemas);
+    }
     /**
      * 进行数据验证
      * @param data 待验证的数据
@@ -175,8 +186,7 @@ class Validator {
                     if (typeof ruleItem === "string") {
                         rules.push(...this._parseStringRule(ruleItem, schema.message));
                     }
-                    else if (ruleItem instanceof RegExp ||
-                        typeof ruleItem === "function") {
+                    else if (ruleItem instanceof RegExp || typeof ruleItem === "function") {
                         rules.push({
                             rule: ruleItem,
                             message: schema.message || defaultMsg,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ph-utils",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "js 开发工具集，前后端都可以使用(commonjs和es module)",
   "keywords": [
     "date",