@whitesev/domutils 1.5.6 → 1.5.8

package/dist/index.amd.js

@@ -460,6 +460,13 @@ define((function () { 'use strict';
                 globalThis.clearInterval(timeId);
             }
         },
+        /**
+         * 判断是否是元素列表
+         * @param $ele
+         */
+        isNodeList($ele) {
+            return Array.isArray($ele) || $ele instanceof NodeList;
+        },
     };
 
     /* 数据 */
@@ -586,12 +593,12 @@ define((function () { 'use strict';
                             : 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 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.click($ele, handler, details, useDispatchToTriggerEvent);
@@ -1009,7 +1016,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1045,7 +1052,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1081,7 +1088,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.hover($ele, handler, option);
@@ -1114,7 +1121,7 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
                 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 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (typeof property === "string") {
                     if (value == null) {
                         // 获取属性
@@ -1532,7 +1657,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (text == null) {
                     // 获取
                     return DOMUtilsContext.text(element[0]);
@@ -1568,7 +1693,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (html == null) {
                     // 获取
                     return DOMUtilsContext.html(element[0]);
@@ -1638,7 +1763,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (value == null) {
                     // 获取
                     return DOMUtilsContext.val(element[0]);
@@ -1680,7 +1805,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (propValue == null) {
                     // 获取
                     return DOMUtilsContext.prop(element[0], propName);
@@ -1722,7 +1847,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeAttr($ele, attrName);
@@ -1748,7 +1873,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeClass($ele, className);
@@ -1785,7 +1910,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeProp($ele, propName);
@@ -1811,7 +1936,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.replaceWith($ele, newElement);
@@ -1840,7 +1965,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.addClass($ele, className);
@@ -1870,7 +1995,7 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.append($ele, content);
@@ -1956,7 +2081,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.prepend($ele, content);
@@ -1993,7 +2118,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.after($ele, content);
@@ -2032,7 +2157,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.before($ele, content);
@@ -2069,7 +2194,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 element.forEach(($ele) => {
                     DOMUtilsContext.remove($ele);
                 });
@@ -2093,7 +2218,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.empty($ele);
@@ -2300,7 +2425,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.animate($ele, styles, duration, callback);
@@ -2362,7 +2487,7 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.wrap($ele, wrapperHTML);
@@ -2442,7 +2567,7 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             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 @@ define((function () { 'use strict';
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.toggle($ele);