@whitesev/domutils 1.5.11 → 1.6.1

package/dist/index.umd.js

@@ -284,7 +284,7 @@
     };
 
     // This is the minified and stringified code of the worker-timers-worker package.
-    const worker = `(()=>{var e={455:function(e,t){!function(e){"use strict";var t=function(e){return function(t){var r=e(t);return t.add(r),r}},r=function(e){return function(t,r){return e.set(t,r),r}},n=void 0===Number.MAX_SAFE_INTEGER?9007199254740991:Number.MAX_SAFE_INTEGER,o=536870912,s=2*o,a=function(e,t){return function(r){var a=t.get(r),i=void 0===a?r.size:a<s?a+1:0;if(!r.has(i))return e(r,i);if(r.size<o){for(;r.has(i);)i=Math.floor(Math.random()*s);return e(r,i)}if(r.size>n)throw new Error("Congratulations, you created a collection of unique numbers which uses all available integers!");for(;r.has(i);)i=Math.floor(Math.random()*n);return e(r,i)}},i=new WeakMap,u=r(i),c=a(u,i),d=t(c);e.addUniqueNumber=d,e.generateUniqueNumber=c}(t)}},t={};function r(n){var o=t[n];if(void 0!==o)return o.exports;var s=t[n]={exports:{}};return e[n].call(s.exports,s,s.exports,r),s.exports}(()=>{"use strict";const e=-32603,t=-32602,n=-32601,o=(e,t)=>Object.assign(new Error(e),{status:t}),s=t=>o('The handler of the method called "'.concat(t,'" returned an unexpected result.'),e),a=(t,r)=>async({data:{id:a,method:i,params:u}})=>{const c=r[i];try{if(void 0===c)throw(e=>o('The requested method called "'.concat(e,'" is not supported.'),n))(i);const r=void 0===u?c():c(u);if(void 0===r)throw(t=>o('The handler of the method called "'.concat(t,'" returned no required result.'),e))(i);const d=r instanceof Promise?await r:r;if(null===a){if(void 0!==d.result)throw s(i)}else{if(void 0===d.result)throw s(i);const{result:e,transferables:r=[]}=d;t.postMessage({id:a,result:e},r)}}catch(e){const{message:r,status:n=-32603}=e;t.postMessage({error:{code:n,message:r},id:a})}};var i=r(455);const u=new Map,c=(e,r,n)=>({...r,connect:({port:t})=>{t.start();const n=e(t,r),o=(0,i.generateUniqueNumber)(u);return u.set(o,(()=>{n(),t.close(),u.delete(o)})),{result:o}},disconnect:({portId:e})=>{const r=u.get(e);if(void 0===r)throw(e=>o('The specified parameter called "portId" with the given value "'.concat(e,'" does not identify a port connected to this worker.'),t))(e);return r(),{result:null}},isSupported:async()=>{if(await new Promise((e=>{const t=new ArrayBuffer(0),{port1:r,port2:n}=new MessageChannel;r.onmessage=({data:t})=>e(null!==t),n.postMessage(t,[t])}))){const e=n();return{result:e instanceof Promise?await e:e}}return{result:!1}}}),d=(e,t,r=()=>!0)=>{const n=c(d,t,r),o=a(e,n);return e.addEventListener("message",o),()=>e.removeEventListener("message",o)},l=e=>t=>{const r=e.get(t);if(void 0===r)return Promise.resolve(!1);const[n,o]=r;return clearTimeout(n),e.delete(t),o(!1),Promise.resolve(!0)},f=(e,t,r)=>(n,o,s)=>{const{expected:a,remainingDelay:i}=e(n,o);return new Promise((e=>{t.set(s,[setTimeout(r,i,a,t,e,s),e])}))},m=(e,t)=>{const r=performance.now(),n=e+t-r-performance.timeOrigin;return{expected:r+n,remainingDelay:n}},p=(e,t,r,n)=>{const o=e-performance.now();o>0?t.set(n,[setTimeout(p,o,e,t,r,n),r]):(t.delete(n),r(!0))},h=new Map,v=l(h),w=new Map,g=l(w),M=f(m,h,p),y=f(m,w,p);d(self,{clear:async({timerId:e,timerType:t})=>({result:await("interval"===t?v(e):g(e))}),set:async({delay:e,now:t,timerId:r,timerType:n})=>({result:await("interval"===n?M:y)(e,t,r)})})})()})();`; // tslint:disable-line:max-line-length
+    const worker = `(()=>{var e={455:function(e,t){!function(e){"use strict";var t=function(e){return function(t){var r=e(t);return t.add(r),r}},r=function(e){return function(t,r){return e.set(t,r),r}},n=void 0===Number.MAX_SAFE_INTEGER?9007199254740991:Number.MAX_SAFE_INTEGER,o=536870912,s=2*o,a=function(e,t){return function(r){var a=t.get(r),i=void 0===a?r.size:a<s?a+1:0;if(!r.has(i))return e(r,i);if(r.size<o){for(;r.has(i);)i=Math.floor(Math.random()*s);return e(r,i)}if(r.size>n)throw new Error("Congratulations, you created a collection of unique numbers which uses all available integers!");for(;r.has(i);)i=Math.floor(Math.random()*n);return e(r,i)}},i=new WeakMap,u=r(i),c=a(u,i),l=t(c);e.addUniqueNumber=l,e.generateUniqueNumber=c}(t)}},t={};function r(n){var o=t[n];if(void 0!==o)return o.exports;var s=t[n]={exports:{}};return e[n].call(s.exports,s,s.exports,r),s.exports}(()=>{"use strict";const e=-32603,t=-32602,n=-32601,o=(e,t)=>Object.assign(new Error(e),{status:t}),s=t=>o('The handler of the method called "'.concat(t,'" returned an unexpected result.'),e),a=(t,r)=>async({data:{id:a,method:i,params:u}})=>{const c=r[i];try{if(void 0===c)throw(e=>o('The requested method called "'.concat(e,'" is not supported.'),n))(i);const r=void 0===u?c():c(u);if(void 0===r)throw(t=>o('The handler of the method called "'.concat(t,'" returned no required result.'),e))(i);const l=r instanceof Promise?await r:r;if(null===a){if(void 0!==l.result)throw s(i)}else{if(void 0===l.result)throw s(i);const{result:e,transferables:r=[]}=l;t.postMessage({id:a,result:e},r)}}catch(e){const{message:r,status:n=-32603}=e;t.postMessage({error:{code:n,message:r},id:a})}};var i=r(455);const u=new Map,c=(e,r,n)=>({...r,connect:({port:t})=>{t.start();const n=e(t,r),o=(0,i.generateUniqueNumber)(u);return u.set(o,(()=>{n(),t.close(),u.delete(o)})),{result:o}},disconnect:({portId:e})=>{const r=u.get(e);if(void 0===r)throw(e=>o('The specified parameter called "portId" with the given value "'.concat(e,'" does not identify a port connected to this worker.'),t))(e);return r(),{result:null}},isSupported:async()=>{if(await new Promise((e=>{const t=new ArrayBuffer(0),{port1:r,port2:n}=new MessageChannel;r.onmessage=({data:t})=>e(null!==t),n.postMessage(t,[t])}))){const e=n();return{result:e instanceof Promise?await e:e}}return{result:!1}}}),l=(e,t,r=()=>!0)=>{const n=c(l,t,r),o=a(e,n);return e.addEventListener("message",o),()=>e.removeEventListener("message",o)},d=(e,t)=>r=>{const n=t.get(r);if(void 0===n)return Promise.resolve(!1);const[o,s]=n;return e(o),t.delete(r),s(!1),Promise.resolve(!0)},f=(e,t,r,n)=>(o,s,a)=>{const i=o+s-t.timeOrigin,u=i-t.now();return new Promise((t=>{e.set(a,[r(n,u,i,e,t,a),t])}))},m=new Map,h=d(globalThis.clearTimeout,m),p=new Map,v=d(globalThis.clearTimeout,p),w=((e,t)=>{const r=(n,o,s,a)=>{const i=n-e.now();i>0?o.set(a,[t(r,i,n,o,s,a),s]):(o.delete(a),s(!0))};return r})(performance,globalThis.setTimeout),g=f(m,performance,globalThis.setTimeout,w),T=f(p,performance,globalThis.setTimeout,w);l(self,{clear:async({timerId:e,timerType:t})=>({result:await("interval"===t?h(e):v(e))}),set:async({delay:e,now:t,timerId:r,timerType:n})=>({result:await("interval"===n?g:T)(e,t,r)})})})()})();`; // tslint:disable-line:max-line-length
 
     const loadOrReturnBroker = createLoadOrReturnBroker(load, worker);
     const clearInterval = (timerId) => loadOrReturnBroker().clearInterval(timerId);
@@ -484,6 +484,14 @@
         isNodeList($ele) {
             return Array.isArray($ele) || $ele instanceof NodeList;
         },
+        /** 获取 animationend 在各个浏览器的兼容名 */
+        getAnimationEndNameList() {
+            return ["webkitAnimationEnd", "mozAnimationEnd", "MSAnimationEnd", "oanimationend", "animationend"];
+        },
+        /** 获取 transitionend 在各个浏览器的兼容名 */
+        getTransitionEndNameList() {
+            return ["webkitTransitionEnd", "mozTransitionEnd", "MSTransitionEnd", "otransitionend", "transitionend"];
+        },
     };
 
     /* 数据 */
@@ -606,8 +614,7 @@
                             : event.target;
                         let totalParent = elementItem;
                         if (DOMUtilsCommonUtils.isWin(totalParent)) {
-                            if (totalParent ===
-                                DOMUtilsContext.windowApi.document) {
+                            if (totalParent === DOMUtilsContext.windowApi.document) {
                                 totalParent = DOMUtilsContext.windowApi.document.documentElement;
                             }
                         }
@@ -675,8 +682,7 @@
                 if (typeof currentParam === "boolean") {
                     option.capture = currentParam;
                 }
-                else if (typeof currentParam === "object" &&
-                    "capture" in currentParam) {
+                else if (typeof currentParam === "object" && "capture" in currentParam) {
                     option.capture = currentParam.capture;
                 }
                 return option;
@@ -738,8 +744,7 @@
                 // 目标函数、事件名
                 isRemoveAll = true;
             }
-            else if ((args.length === 3 && typeof args[2] === "string") ||
-                Array.isArray(args[2])) {
+            else if ((args.length === 3 && typeof args[2] === "string") || Array.isArray(args[2])) {
                 // 目标函数、事件名、子元素选择器
                 isRemoveAll = true;
             }
@@ -754,9 +759,7 @@
                     for (let index = 0; index < handlers.length; index++) {
                         let handler = handlers[index];
                         let flag = true;
-                        if (flag &&
-                            listenerCallBack &&
-                            handler.originCallBack !== listenerCallBack) {
+                        if (flag && listenerCallBack && handler.originCallBack !== listenerCallBack) {
                             // callback不同
                             flag = false;
                         }
@@ -816,9 +819,7 @@
                         return;
                     }
                     let elementEvents = elementItem[symbolEvents] || {};
-                    let iterEventNameList = eventTypeList.length
-                        ? eventTypeList
-                        : Object.keys(elementEvents);
+                    let iterEventNameList = eventTypeList.length ? eventTypeList : Object.keys(elementEvents);
                     iterEventNameList.forEach((eventName) => {
                         let handlers = elementEvents[eventName];
                         if (!handlers) {
@@ -855,8 +856,7 @@
                 try {
                     if (DOMUtilsContext.windowApi.document.readyState === "complete" ||
                         (DOMUtilsContext.windowApi.document.readyState !== "loading" &&
-                            !DOMUtilsContext.windowApi.document.documentElement
-                                .doScroll)) {
+                            !DOMUtilsContext.windowApi.document.documentElement.doScroll)) {
                         return true;
                     }
                     else {
@@ -1117,6 +1117,76 @@
             DOMUtilsContext.on(element, "mouseenter", null, handler, option);
             DOMUtilsContext.on(element, "mouseleave", null, handler, option);
         }
+        /**
+         * 当动画结束时触发事件
+         * @param element 监听的元素
+         * @param handler 触发的回调函数
+         * @param option 配置项，这里默认配置once为true
+         */
+        animationend(element, handler, option) {
+            let DOMUtilsContext = this;
+            if (typeof element === "string") {
+                element = DOMUtilsContext.selector(element);
+            }
+            if (element == null) {
+                return;
+            }
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
+                // 设置
+                element.forEach(($ele) => {
+                    DOMUtilsContext.animationend($ele, handler, option);
+                });
+                return;
+            }
+            const defaultOption = {
+                once: true,
+            };
+            Object.assign(defaultOption, option || {});
+            const eventNameList = DOMUtilsCommonUtils.getAnimationEndNameList();
+            DOMUtilsContext.on(element, eventNameList, null, handler, defaultOption);
+            if (!defaultOption.once) {
+                return {
+                    off() {
+                        DOMUtilsContext.off(element, eventNameList, null, handler, defaultOption);
+                    },
+                };
+            }
+        }
+        /**
+         * 当过渡结束时触发事件
+         * @param element 监听的元素
+         * @param handler 触发的回调函数
+         * @param option 配置项，这里默认配置once为true
+         */
+        transitionend(element, handler, option) {
+            let DOMUtilsContext = this;
+            if (typeof element === "string") {
+                element = DOMUtilsContext.selector(element);
+            }
+            if (element == null) {
+                return;
+            }
+            if (DOMUtilsCommonUtils.isNodeList(element)) {
+                // 设置
+                element.forEach(($ele) => {
+                    DOMUtilsContext.transitionend($ele, handler, option);
+                });
+                return;
+            }
+            const defaultOption = {
+                once: true,
+            };
+            Object.assign(defaultOption, option || {});
+            const eventNameList = DOMUtilsCommonUtils.getTransitionEndNameList();
+            DOMUtilsContext.on(element, eventNameList, null, handler, defaultOption);
+            if (!defaultOption.once) {
+                return {
+                    off() {
+                        DOMUtilsContext.off(element, eventNameList, null, handler, defaultOption);
+                    },
+                };
+            }
+        }
         /**
          * 当按键松开时触发事件
          * keydown - > keypress - > keyup
@@ -1491,7 +1561,7 @@
             super(option);
         }
         /** 版本号 */
-        version = "2025.6.26";
+        version = "2025.8.11";
         attr(element, attrName, attrValue) {
             let DOMUtilsContext = this;
             if (typeof element === "string") {
@@ -1585,15 +1655,7 @@
              * 把纯数字没有px的加上
              */
             function handlePixe(propertyName, propertyValue) {
-                let allowAddPixe = [
-                    "width",
-                    "height",
-                    "top",
-                    "left",
-                    "right",
-                    "bottom",
-                    "font-size",
-                ];
+                let allowAddPixe = ["width", "height", "top", "left", "right", "bottom", "font-size"];
                 if (typeof propertyValue === "number") {
                     propertyValue = propertyValue.toString();
                 }
@@ -1635,8 +1697,7 @@
                 return;
             }
             let setStyleProperty = (propertyName, propertyValue) => {
-                if (typeof propertyValue === "string" &&
-                    propertyValue.trim().endsWith("!important")) {
+                if (typeof propertyValue === "string" && propertyValue.trim().endsWith("!important")) {
                     propertyValue = propertyValue
                         .trim()
                         .replace(/!important$/gi, "")
@@ -1650,9 +1711,7 @@
             };
             if (typeof property === "string") {
                 if (value == null) {
-                    return DOMUtilsContext.windowApi.globalThis
-                        .getComputedStyle(element)
-                        .getPropertyValue(property);
+                    return DOMUtilsContext.windowApi.globalThis.getComputedStyle(element).getPropertyValue(property);
                 }
                 else {
                     setStyleProperty(property, value);
@@ -1755,12 +1814,8 @@
                 return transformInfo;
             }
             let elementTransform = DOMUtilsContext.windowApi.globalThis.getComputedStyle(element).transform;
-            if (elementTransform != null &&
-                elementTransform !== "none" &&
-                elementTransform !== "") {
-                let elementTransformSplit = elementTransform
-                    .match(/\((.+)\)/)?.[1]
-                    .split(",");
+            if (elementTransform != null && elementTransform !== "none" && elementTransform !== "") {
+                let elementTransformSplit = elementTransform.match(/\((.+)\)/)?.[1].split(",");
                 if (elementTransformSplit) {
                     transform_left = Math.abs(parseInt(elementTransformSplit[4]));
                     transform_top = Math.abs(parseInt(elementTransformSplit[5]));
@@ -1798,8 +1853,7 @@
             }
             if (value == null) {
                 // 获取
-                if (element.localName === "input" &&
-                    (element.type === "checkbox" || element.type === "radio")) {
+                if (element.localName === "input" && (element.type === "checkbox" || element.type === "radio")) {
                     return element.checked;
                 }
                 else {
@@ -1808,8 +1862,7 @@
             }
             else {
                 // 设置
-                if (element.localName === "input" &&
-                    (element.type === "checkbox" || element.type === "radio")) {
+                if (element.localName === "input" && (element.type === "checkbox" || element.type === "radio")) {
                     element.checked = !!value;
                 }
                 else {
@@ -2063,7 +2116,15 @@
             }
             function elementAppendChild(ele, text) {
                 if (typeof content === "string") {
-                    ele.insertAdjacentHTML("beforeend", DOMUtilsCommonUtils.getSafeHTML(text));
+                    if (ele instanceof DocumentFragment) {
+                        if (typeof text === "string") {
+                            text = DOMUtilsContext.parseHTML(text, true, false);
+                        }
+                        ele.appendChild(text);
+                    }
+                    else {
+                        ele.insertAdjacentHTML("beforeend", DOMUtilsCommonUtils.getSafeHTML(text));
+                    }
                 }
                 else {
                     ele.appendChild(text);
@@ -2074,6 +2135,7 @@
                 let fragment = DOMUtilsContext.windowApi.document.createDocumentFragment();
                 content.forEach((ele) => {
                     if (typeof ele === "string") {
+                        // 转为元素
                         ele = DOMUtilsContext.parseHTML(ele, true, false);
                     }
                     fragment.appendChild(ele);
@@ -2109,7 +2171,13 @@
                 return;
             }
             if (typeof content === "string") {
-                element.insertAdjacentHTML("afterbegin", DOMUtilsCommonUtils.getSafeHTML(content));
+                if (element instanceof DocumentFragment) {
+                    content = DOMUtilsContext.parseHTML(content, true, false);
+                    element.prepend(content);
+                }
+                else {
+                    element.insertAdjacentHTML("afterbegin", DOMUtilsCommonUtils.getSafeHTML(content));
+                }
             }
             else {
                 let $firstChild = element.firstChild;
@@ -2282,16 +2350,14 @@
                 return;
             }
             if (DOMUtilsCommonUtils.isWin(element)) {
-                return DOMUtilsContext.windowApi.window.document.documentElement
-                    .clientWidth;
+                return DOMUtilsContext.windowApi.window.document.documentElement.clientWidth;
             }
             if (element.nodeType === 9) {
                 /* Document文档节点 */
                 element = element;
                 return Math.max(element.body.scrollWidth, element.documentElement.scrollWidth, element.body.offsetWidth, element.documentElement.offsetWidth, element.documentElement.clientWidth);
             }
-            if (isShow ||
-                (!isShow && DOMUtilsCommonUtils.isShow(element))) {
+            if (isShow || (!isShow && DOMUtilsCommonUtils.isShow(element))) {
                 /* 已显示 */
                 /* 不从style中获取对应的宽度，因为可能使用了class定义了width !important */
                 element = element;
@@ -2326,8 +2392,7 @@
         height(element, isShow = false) {
             let DOMUtilsContext = this;
             if (DOMUtilsCommonUtils.isWin(element)) {
-                return DOMUtilsContext.windowApi.window.document.documentElement
-                    .clientHeight;
+                return DOMUtilsContext.windowApi.window.document.documentElement.clientHeight;
             }
             if (typeof element === "string") {
                 element = DOMUtilsContext.selector(element);
@@ -2341,8 +2406,7 @@
                 /* Document文档节点 */
                 return Math.max(element.body.scrollHeight, element.documentElement.scrollHeight, element.body.offsetHeight, element.documentElement.offsetHeight, element.documentElement.clientHeight);
             }
-            if (isShow ||
-                (!isShow && DOMUtilsCommonUtils.isShow(element))) {
+            if (isShow || (!isShow && DOMUtilsCommonUtils.isShow(element))) {
                 element = element;
                 /* 已显示 */
                 /* 从style中获取对应的高度，因为可能使用了class定义了width !important */
@@ -2470,8 +2534,7 @@
             let to = {};
             for (let prop in styles) {
                 from[prop] =
-                    element.style[prop] ||
-                        DOMUtilsContext.windowApi.globalThis.getComputedStyle(element)[prop];
+                    element.style[prop] || DOMUtilsContext.windowApi.globalThis.getComputedStyle(element)[prop];
                 to[prop] = styles[prop];
             }
             let timer = DOMUtilsCommonUtils.setInterval(function () {
@@ -2481,8 +2544,7 @@
                     progress = 1;
                 }
                 for (let prop in styles) {
-                    element.style[prop] =
-                        from[prop] + (to[prop] - from[prop]) * progress + "px";
+                    element.style[prop] = from[prop] + (to[prop] - from[prop]) * progress + "px";
                 }
                 if (progress === 1) {
                     DOMUtilsCommonUtils.clearInterval(timer);
@@ -2567,8 +2629,7 @@
             if (element == null) {
                 return;
             }
-            return Array.from(element.parentElement
-                .children).filter((child) => child !== element);
+            return Array.from(element.parentElement.children).filter((child) => child !== element);
         }
         /**
          * 获取当前元素的父元素
@@ -2644,14 +2705,7 @@
                 if (element.name &&
                     !element.disabled &&
                     (element.checked ||
-                        [
-                            "text",
-                            "hidden",
-                            "password",
-                            "textarea",
-                            "select-one",
-                            "select-multiple",
-                        ].includes(element.type))) {
+                        ["text", "hidden", "password", "textarea", "select-one", "select-multiple"].includes(element.type))) {
                     if (element.type === "select-multiple") {
                         for (let j = 0; j < element.options.length; j++) {
                             if (element.options[j].selected) {
@@ -2871,9 +2925,7 @@
                 });
                 return;
             }
-            if (DOMUtilsContext.windowApi.globalThis
-                .getComputedStyle(element)
-                .getPropertyValue("display") === "none") {
+            if (DOMUtilsContext.windowApi.globalThis.getComputedStyle(element).getPropertyValue("display") === "none") {
                 DOMUtilsContext.show(element, checkVisiblie);
             }
             else {
@@ -2918,9 +2970,7 @@
                 selectionStart = Math.min($input.value.length, selectionStart);
             if (typeof selectionEnd == "string")
                 selectionEnd = parseFloat(selectionEnd);
-            if (typeof selectionEnd != "number" ||
-                isNaN(selectionEnd) ||
-                selectionEnd < selectionStart) {
+            if (typeof selectionEnd != "number" || isNaN(selectionEnd) || selectionEnd < selectionStart) {
                 selectionEnd = selectionStart;
             }
             if (selectionEnd < 0)
@@ -3007,11 +3057,7 @@
                 var isBoxModel = $box.offsetWidth == 2;
                 body.removeChild($box);
                 let $boxRect = $input.getBoundingClientRect();
-                var clientTop = docElem.clientTop || body.clientTop || 0, clientLeft = docElem.clientLeft || body.clientLeft || 0, scrollTop = win.pageYOffset ||
-                    (isBoxModel && docElem.scrollTop) ||
-                    body.scrollTop, scrollLeft = win.pageXOffset ||
-                    (isBoxModel && docElem.scrollLeft) ||
-                    body.scrollLeft;
+                var clientTop = docElem.clientTop || body.clientTop || 0, clientLeft = docElem.clientLeft || body.clientLeft || 0, scrollTop = win.pageYOffset || (isBoxModel && docElem.scrollTop) || body.scrollTop, scrollLeft = win.pageXOffset || (isBoxModel && docElem.scrollLeft) || body.scrollLeft;
                 return {
                     top: $boxRect.top + scrollTop - clientTop,
                     left: $boxRect.left + scrollLeft - clientLeft,
@@ -3030,6 +3076,14 @@
                 return isNumber ? parseFloat(val) : val;
             }
         }
+        /** 获取 animationend 在各个浏览器的兼容名 */
+        getAnimationEndNameList() {
+            return DOMUtilsCommonUtils.getAnimationEndNameList();
+        }
+        /** 获取 transitionend 在各个浏览器的兼容名 */
+        getTransitionEndNameList() {
+            return DOMUtilsCommonUtils.getTransitionEndNameList();
+        }
     }
     let domUtils = new DOMUtils();