@whitesev/domutils 1.5.6 → 1.5.8

package/dist/index.cjs.js

@@ -460,6 +460,13 @@ const DOMUtilsCommonUtils = {
             globalThis.clearInterval(timeId);
         }
     },
+    /**
+     * 判断是否是元素列表
+     * @param $ele
+     */
+    isNodeList($ele) {
+        return Array.isArray($ele) || $ele instanceof NodeList;
+    },
 };
 
 /* 数据 */
@@ -586,12 +593,12 @@ class DOMUtilsEvent {
                         : elementItem;
                     let findValue = selectorList.find((selectorItem) => {
                         // 判断目标元素是否匹配选择器
-                        if (eventTarget?.matches(selectorItem)) {
+                        if (DOMUtilsContext.matches(eventTarget, selectorItem)) {
                             /* 当前目标可以被selector所匹配到 */
                             return true;
                         }
                         /* 在上层与主元素之间寻找可以被selector所匹配到的 */
-                        let $closestMatches = eventTarget?.closest(selectorItem);
+                        let $closestMatches = DOMUtilsContext.closest(eventTarget, selectorItem);
                         if ($closestMatches && totalParent?.contains($closestMatches)) {
                             eventTarget = $closestMatches;
                             return true;
@@ -973,7 +980,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.click($ele, handler, details, useDispatchToTriggerEvent);
@@ -1009,7 +1016,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1045,7 +1052,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1081,7 +1088,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.hover($ele, handler, option);
@@ -1114,7 +1121,7 @@ class DOMUtilsEvent {
         if (typeof element === "string") {
             element = DOMUtilsContext.selectorAll(element);
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.keyup($ele, handler, option);
@@ -1146,7 +1153,7 @@ class DOMUtilsEvent {
         if (typeof element === "string") {
             element = DOMUtilsContext.selectorAll(element);
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.keydown($ele, handler, option);
@@ -1178,7 +1185,7 @@ class DOMUtilsEvent {
         if (typeof element === "string") {
             element = DOMUtilsContext.selectorAll(element);
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.keypress($ele, handler, option);
@@ -1332,21 +1339,139 @@ class DOMUtilsEvent {
             return Array.from(context.windowApi.document.querySelectorAll(selector));
         }
     }
+    /**
+     * 匹配元素，可使用以下的额外语法
+     *
+     * + :contains([text]) 作用: 找到包含指定文本内容的指定元素
+     * + :empty 作用:找到既没有文本内容也没有子元素的指定元素
+     * + :regexp([text]) 作用: 找到符合正则表达式的内容的指定元素
+     * @param $el 元素
+     * @param selector 选择器
+     * @example
+     * DOMUtils.matches("div:contains('测试')")
+     * > true
+     * @example
+     * DOMUtils.matches("div:empty")
+     * > true
+     * @example
+     * DOMUtils.matches("div:regexp('^xxxx$')")
+     * > true
+     * @example
+     * DOMUtils.matches("div:regexp(/^xxx/ig)")
+     * > false
+     */
+    matches($el, selector) {
+        selector = selector.trim();
+        if ($el == null) {
+            return false;
+        }
+        if (selector.match(/[^\s]{1}:empty$/gi)) {
+            // empty 语法
+            selector = selector.replace(/:empty$/gi, "");
+            return $el.matches(selector) && $el?.innerHTML?.trim() === "";
+        }
+        else if (selector.match(/[^\s]{1}:contains\("(.*)"\)$/i) ||
+            selector.match(/[^\s]{1}:contains\('(.*)'\)$/i)) {
+            // contains 语法
+            let textMatch = selector.match(/:contains\(("|')(.*)("|')\)$/i);
+            let text = textMatch[2];
+            selector = selector.replace(/:contains\(("|')(.*)("|')\)$/gi, "");
+            // @ts-ignore
+            let content = $el?.textContent || $el?.innerText;
+            if (typeof content !== "string") {
+                content = "";
+            }
+            return $el.matches(selector) && content?.includes(text);
+        }
+        else if (selector.match(/[^\s]{1}:regexp\("(.*)"\)$/i) ||
+            selector.match(/[^\s]{1}:regexp\('(.*)'\)$/i)) {
+            // regexp 语法
+            let textMatch = selector.match(/:regexp\(("|')(.*)("|')\)$/i);
+            let pattern = textMatch[2];
+            let flagMatch = pattern.match(/("|'),[\s]*("|')([igm]{0,3})$/i);
+            let flags = "";
+            if (flagMatch) {
+                pattern = pattern.replace(/("|'),[\s]*("|')([igm]{0,3})$/gi, "");
+                flags = flagMatch[3];
+            }
+            let regexp = new RegExp(pattern, flags);
+            selector = selector.replace(/:regexp\(("|')(.*)("|')\)$/gi, "");
+            // @ts-ignore
+            let content = $el?.textContent || $el?.innerText;
+            if (typeof content !== "string") {
+                content = "";
+            }
+            return $el.matches(selector) && Boolean(content?.match(regexp));
+        }
+        else {
+            // 普通语法
+            return $el.matches(selector);
+        }
+    }
+    closest($el, selector) {
+        selector = selector.trim();
+        if (selector.match(/[^\s]{1}:empty$/gi)) {
+            // empty 语法
+            selector = selector.replace(/:empty$/gi, "");
+            let $closest = $el?.closest(selector);
+            if ($closest && $closest?.innerHTML?.trim() === "") {
+                return $closest;
+            }
+            return null;
+        }
+        else if (selector.match(/[^\s]{1}:contains\("(.*)"\)$/i) ||
+            selector.match(/[^\s]{1}:contains\('(.*)'\)$/i)) {
+            // contains 语法
+            let textMatch = selector.match(/:contains\(("|')(.*)("|')\)$/i);
+            let text = textMatch[2];
+            selector = selector.replace(/:contains\(("|')(.*)("|')\)$/gi, "");
+            let $closest = $el?.closest(selector);
+            if ($closest) {
+                // @ts-ignore
+                let content = $el?.textContent || $el?.innerText;
+                if (typeof content === "string" && content.includes(text)) {
+                    return $closest;
+                }
+            }
+            return null;
+        }
+        else if (selector.match(/[^\s]{1}:regexp\("(.*)"\)$/i) ||
+            selector.match(/[^\s]{1}:regexp\('(.*)'\)$/i)) {
+            // regexp 语法
+            let textMatch = selector.match(/:regexp\(("|')(.*)("|')\)$/i);
+            let pattern = textMatch[2];
+            let flagMatch = pattern.match(/("|'),[\s]*("|')([igm]{0,3})$/i);
+            let flags = "";
+            if (flagMatch) {
+                pattern = pattern.replace(/("|'),[\s]*("|')([igm]{0,3})$/gi, "");
+                flags = flagMatch[3];
+            }
+            let regexp = new RegExp(pattern, flags);
+            selector = selector.replace(/:regexp\(("|')(.*)("|')\)$/gi, "");
+            let $closest = $el?.closest(selector);
+            if ($closest) {
+                // @ts-ignore
+                let content = $el?.textContent || $el?.innerText;
+                if (typeof content === "string" && content.match(regexp)) {
+                    return $closest;
+                }
+            }
+            return null;
+        }
+        else {
+            // 普通语法
+            let $closest = $el?.closest(selector);
+            return $closest;
+        }
+    }
 }
 
-/**
- * 判断是否是元素列表
- * @param $ele
- */
-const isNodeList = ($ele) => {
-    return Array.isArray($ele) || $ele instanceof NodeList;
-};
 class DOMUtils extends DOMUtilsEvent {
     constructor(option) {
         super(option);
     }
     /** 版本号 */
-    version = "2025.5.26";
+    version = "2025.5.30";
     attr(element, attrName, attrValue) {
         let DOMUtilsContext = this;
         if (typeof element === "string") {
@@ -1355,7 +1480,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (attrValue == null) {
                 // 获取属性
                 return DOMUtilsContext.attr(element[0], attrName, attrValue);
@@ -1465,7 +1590,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (typeof property === "string") {
                 if (value == null) {
                     // 获取属性
@@ -1532,7 +1657,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (text == null) {
                 // 获取
                 return DOMUtilsContext.text(element[0]);
@@ -1568,7 +1693,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (html == null) {
                 // 获取
                 return DOMUtilsContext.html(element[0]);
@@ -1638,7 +1763,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (value == null) {
                 // 获取
                 return DOMUtilsContext.val(element[0]);
@@ -1680,7 +1805,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (propValue == null) {
                 // 获取
                 return DOMUtilsContext.prop(element[0], propName);
@@ -1722,7 +1847,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.removeAttr($ele, attrName);
@@ -1748,7 +1873,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.removeClass($ele, className);
@@ -1785,7 +1910,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.removeProp($ele, propName);
@@ -1811,7 +1936,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.replaceWith($ele, newElement);
@@ -1840,7 +1965,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.addClass($ele, className);
@@ -1870,7 +1995,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return false;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             let flag = true;
             for (let index = 0; index < element.length; index++) {
                 const $ele = element[index];
@@ -1909,7 +2034,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.append($ele, content);
@@ -1956,7 +2081,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.prepend($ele, content);
@@ -1993,7 +2118,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.after($ele, content);
@@ -2032,7 +2157,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.before($ele, content);
@@ -2069,7 +2194,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             element.forEach(($ele) => {
                 DOMUtilsContext.remove($ele);
             });
@@ -2093,7 +2218,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.empty($ele);
@@ -2300,7 +2425,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.animate($ele, styles, duration, callback);
@@ -2362,7 +2487,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.wrap($ele, wrapperHTML);
@@ -2442,7 +2567,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             let resultArray = [];
             element.forEach(($ele) => {
                 resultArray.push(DOMUtilsContext.parent($ele));
@@ -2621,7 +2746,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (typeof element === "string") {
             element = DOMUtilsContext.selectorAll(element);
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.fadeIn($ele, duration, callback);
@@ -2672,7 +2797,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (typeof element === "string") {
             element = DOMUtilsContext.selectorAll(element);
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.fadeOut($ele, duration, callback);
@@ -2718,7 +2843,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.toggle($ele);