@whitesev/domutils 1.5.6 → 1.5.8

package/dist/index.esm.js

@@ -458,6 +458,13 @@ const DOMUtilsCommonUtils = {
             globalThis.clearInterval(timeId);
         }
     },
+    /**
+     * 判断是否是元素列表
+     * @param $ele
+     */
+    isNodeList($ele) {
+        return Array.isArray($ele) || $ele instanceof NodeList;
+    },
 };
 
 /* 数据 */
@@ -584,12 +591,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;
@@ -971,7 +978,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.click($ele, handler, details, useDispatchToTriggerEvent);
@@ -1007,7 +1014,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1043,7 +1050,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1079,7 +1086,7 @@ class DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.hover($ele, handler, option);
@@ -1112,7 +1119,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);
@@ -1144,7 +1151,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);
@@ -1176,7 +1183,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);
@@ -1330,21 +1337,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") {
@@ -1353,7 +1478,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);
@@ -1463,7 +1588,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (typeof property === "string") {
                 if (value == null) {
                     // 获取属性
@@ -1530,7 +1655,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (text == null) {
                 // 获取
                 return DOMUtilsContext.text(element[0]);
@@ -1566,7 +1691,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (html == null) {
                 // 获取
                 return DOMUtilsContext.html(element[0]);
@@ -1636,7 +1761,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             if (value == null) {
                 // 获取
                 return DOMUtilsContext.val(element[0]);
@@ -1678,7 +1803,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);
@@ -1720,7 +1845,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.removeAttr($ele, attrName);
@@ -1746,7 +1871,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.removeClass($ele, className);
@@ -1783,7 +1908,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.removeProp($ele, propName);
@@ -1809,7 +1934,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.replaceWith($ele, newElement);
@@ -1838,7 +1963,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.addClass($ele, className);
@@ -1868,7 +1993,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];
@@ -1907,7 +2032,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.append($ele, content);
@@ -1954,7 +2079,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.prepend($ele, content);
@@ -1991,7 +2116,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.after($ele, content);
@@ -2030,7 +2155,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.before($ele, content);
@@ -2067,7 +2192,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             element.forEach(($ele) => {
                 DOMUtilsContext.remove($ele);
             });
@@ -2091,7 +2216,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.empty($ele);
@@ -2298,7 +2423,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);
@@ -2360,7 +2485,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.wrap($ele, wrapperHTML);
@@ -2440,7 +2565,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));
@@ -2619,7 +2744,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);
@@ -2670,7 +2795,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);
@@ -2716,7 +2841,7 @@ class DOMUtils extends DOMUtilsEvent {
         if (element == null) {
             return;
         }
-        if (isNodeList(element)) {
+        if (DOMUtilsCommonUtils.isNodeList(element)) {
             // 设置
             element.forEach(($ele) => {
                 DOMUtilsContext.toggle($ele);