@whitesev/domutils 1.5.6 → 1.5.8

package/dist/index.umd.js

@@ -464,6 +464,13 @@
                 globalThis.clearInterval(timeId);
             }
         },
+        /**
+         * 判断是否是元素列表
+         * @param $ele
+         */
+        isNodeList($ele) {
+            return Array.isArray($ele) || $ele instanceof NodeList;
+        },
     };
 
     /* 数据 */
@@ -590,12 +597,12 @@
                             : 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;
@@ -977,7 +984,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.click($ele, handler, details, useDispatchToTriggerEvent);
@@ -1013,7 +1020,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1049,7 +1056,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1085,7 +1092,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.hover($ele, handler, option);
@@ -1118,7 +1125,7 @@
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.keyup($ele, handler, option);
@@ -1150,7 +1157,7 @@
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.keydown($ele, handler, option);
@@ -1182,7 +1189,7 @@
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.keypress($ele, handler, option);
@@ -1336,21 +1343,139 @@
                 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") {
@@ -1359,7 +1484,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (attrValue == null) {
                     // 获取属性
                     return DOMUtilsContext.attr(element[0], attrName, attrValue);
@@ -1469,7 +1594,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (typeof property === "string") {
                     if (value == null) {
                         // 获取属性
@@ -1536,7 +1661,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (text == null) {
                     // 获取
                     return DOMUtilsContext.text(element[0]);
@@ -1572,7 +1697,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (html == null) {
                     // 获取
                     return DOMUtilsContext.html(element[0]);
@@ -1642,7 +1767,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (value == null) {
                     // 获取
                     return DOMUtilsContext.val(element[0]);
@@ -1684,7 +1809,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (propValue == null) {
                     // 获取
                     return DOMUtilsContext.prop(element[0], propName);
@@ -1726,7 +1851,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeAttr($ele, attrName);
@@ -1752,7 +1877,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeClass($ele, className);
@@ -1789,7 +1914,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeProp($ele, propName);
@@ -1815,7 +1940,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.replaceWith($ele, newElement);
@@ -1844,7 +1969,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.addClass($ele, className);
@@ -1874,7 +1999,7 @@
             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];
@@ -1913,7 +2038,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.append($ele, content);
@@ -1960,7 +2085,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.prepend($ele, content);
@@ -1997,7 +2122,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.after($ele, content);
@@ -2036,7 +2161,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.before($ele, content);
@@ -2073,7 +2198,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 element.forEach(($ele) => {
                     DOMUtilsContext.remove($ele);
                 });
@@ -2097,7 +2222,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.empty($ele);
@@ -2304,7 +2429,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.animate($ele, styles, duration, callback);
@@ -2366,7 +2491,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.wrap($ele, wrapperHTML);
@@ -2446,7 +2571,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 let resultArray = [];
                 element.forEach(($ele) => {
                     resultArray.push(DOMUtilsContext.parent($ele));
@@ -2625,7 +2750,7 @@
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.fadeIn($ele, duration, callback);
@@ -2676,7 +2801,7 @@
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.fadeOut($ele, duration, callback);
@@ -2722,7 +2847,7 @@
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.toggle($ele);