@whitesev/domutils 1.5.6 → 1.5.8

package/dist/index.iife.js

@@ -461,6 +461,13 @@ var DOMUtils = (function () {
                 globalThis.clearInterval(timeId);
             }
         },
+        /**
+         * 判断是否是元素列表
+         * @param $ele
+         */
+        isNodeList($ele) {
+            return Array.isArray($ele) || $ele instanceof NodeList;
+        },
     };
 
     /* 数据 */
@@ -587,12 +594,12 @@ var DOMUtils = (function () {
                             : 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;
@@ -974,7 +981,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.click($ele, handler, details, useDispatchToTriggerEvent);
@@ -1010,7 +1017,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1046,7 +1053,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.focus($ele, handler, details, useDispatchToTriggerEvent);
@@ -1082,7 +1089,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.hover($ele, handler, option);
@@ -1115,7 +1122,7 @@ var DOMUtils = (function () {
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.keyup($ele, handler, option);
@@ -1147,7 +1154,7 @@ var DOMUtils = (function () {
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.keydown($ele, handler, option);
@@ -1179,7 +1186,7 @@ var DOMUtils = (function () {
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.keypress($ele, handler, option);
@@ -1333,21 +1340,139 @@ var DOMUtils = (function () {
                 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") {
@@ -1356,7 +1481,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (attrValue == null) {
                     // 获取属性
                     return DOMUtilsContext.attr(element[0], attrName, attrValue);
@@ -1466,7 +1591,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (typeof property === "string") {
                     if (value == null) {
                         // 获取属性
@@ -1533,7 +1658,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (text == null) {
                     // 获取
                     return DOMUtilsContext.text(element[0]);
@@ -1569,7 +1694,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (html == null) {
                     // 获取
                     return DOMUtilsContext.html(element[0]);
@@ -1639,7 +1764,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (value == null) {
                     // 获取
                     return DOMUtilsContext.val(element[0]);
@@ -1681,7 +1806,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 if (propValue == null) {
                     // 获取
                     return DOMUtilsContext.prop(element[0], propName);
@@ -1723,7 +1848,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeAttr($ele, attrName);
@@ -1749,7 +1874,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeClass($ele, className);
@@ -1786,7 +1911,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.removeProp($ele, propName);
@@ -1812,7 +1937,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.replaceWith($ele, newElement);
@@ -1841,7 +1966,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.addClass($ele, className);
@@ -1871,7 +1996,7 @@ var DOMUtils = (function () {
             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];
@@ -1910,7 +2035,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.append($ele, content);
@@ -1957,7 +2082,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.prepend($ele, content);
@@ -1994,7 +2119,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.after($ele, content);
@@ -2033,7 +2158,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.before($ele, content);
@@ -2070,7 +2195,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 element.forEach(($ele) => {
                     DOMUtilsContext.remove($ele);
                 });
@@ -2094,7 +2219,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.empty($ele);
@@ -2301,7 +2426,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.animate($ele, styles, duration, callback);
@@ -2363,7 +2488,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.wrap($ele, wrapperHTML);
@@ -2443,7 +2568,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 let resultArray = [];
                 element.forEach(($ele) => {
                     resultArray.push(DOMUtilsContext.parent($ele));
@@ -2622,7 +2747,7 @@ var DOMUtils = (function () {
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.fadeIn($ele, duration, callback);
@@ -2673,7 +2798,7 @@ var DOMUtils = (function () {
             if (typeof element === "string") {
                 element = DOMUtilsContext.selectorAll(element);
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.fadeOut($ele, duration, callback);
@@ -2719,7 +2844,7 @@ var DOMUtils = (function () {
             if (element == null) {
                 return;
             }
-            if (isNodeList(element)) {
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
                 // 设置
                 element.forEach(($ele) => {
                     DOMUtilsContext.toggle($ele);