@whitesev/pops 3.3.2 → 3.3.3

package/dist/index.cjs.js

@@ -293,6 +293,13 @@ class PopsUtils {
     isDOM(target) {
         return target instanceof Node;
     }
+    /**
+     * 判断是否是元素列表
+     * @param $ele
+     */
+    isNodeList($ele) {
+        return Array.isArray($ele) || $ele instanceof NodeList;
+    }
     /**
      * 删除对象上的属性
      * @param target
@@ -1025,7 +1032,7 @@ class PopsDOMUtilsEvent {
      */
     emit(element, eventType, details, useDispatchToEmitEvent = true) {
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -1087,18 +1094,18 @@ class PopsDOMUtilsEvent {
      * })
      * */
     click(element, handler, details, useDispatchToEmitEvent) {
-        const DOMUtilsContext = this;
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
         }
         if (handler == null) {
-            DOMUtilsContext.emit(element, "click", details, useDispatchToEmitEvent);
+            this.emit(element, "click", details, useDispatchToEmitEvent);
         }
         else {
-            DOMUtilsContext.on(element, "click", null, handler);
+            const listener = this.on(element, "click", handler);
+            return listener;
         }
     }
     /**
@@ -1116,18 +1123,18 @@ class PopsDOMUtilsEvent {
      * })
      * */
     blur(element, handler, details, useDispatchToEmitEvent) {
-        const DOMUtilsContext = this;
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
         }
         if (handler === null) {
-            DOMUtilsContext.emit(element, "blur", details, useDispatchToEmitEvent);
+            this.emit(element, "blur", details, useDispatchToEmitEvent);
         }
         else {
-            DOMUtilsContext.on(element, "blur", null, handler);
+            const listener = this.on(element, "blur", handler);
+            return listener;
         }
     }
     /**
@@ -1145,18 +1152,18 @@ class PopsDOMUtilsEvent {
      * })
      * */
     focus(element, handler, details, useDispatchToEmitEvent) {
-        const DOMUtilsContext = this;
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
         }
         if (handler == null) {
-            DOMUtilsContext.emit(element, "focus", details, useDispatchToEmitEvent);
+            this.emit(element, "focus", details, useDispatchToEmitEvent);
         }
         else {
-            DOMUtilsContext.on(element, "focus", null, handler);
+            const listener = this.on(element, "focus", handler);
+            return listener;
         }
     }
     /**
@@ -1174,15 +1181,39 @@ class PopsDOMUtilsEvent {
      * })
      */
     onHover(element, handler, option) {
-        const DOMUtilsContext = this;
+        const that = this;
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = that.selectorAll(element);
         }
         if (element == null) {
             return;
         }
-        DOMUtilsContext.on(element, "mouseenter", null, handler, option);
-        DOMUtilsContext.on(element, "mouseleave", null, handler, option);
+        if (popsUtils.isNodeList(element)) {
+            // 设置
+            const listenerList = [];
+            element.forEach(($ele) => {
+                const listener = that.onHover($ele, handler, option);
+                listenerList.push(listener);
+            });
+            return {
+                off() {
+                    listenerList.forEach((listener) => {
+                        if (!listener) {
+                            return;
+                        }
+                        listener.off();
+                    });
+                },
+            };
+        }
+        const mouseenter_listener = that.on(element, "mouseenter", null, handler, option);
+        const mouseleave_listener = that.on(element, "mouseleave", null, handler, option);
+        return {
+            off() {
+                mouseenter_listener.off();
+                mouseleave_listener.off();
+            },
+        };
     }
     /**
      * 当按键松开时触发事件
@@ -1200,14 +1231,14 @@ class PopsDOMUtilsEvent {
      * })
      */
     onKeyup(target, handler, option) {
-        const DOMUtilsContext = this;
         if (target == null) {
             return;
         }
         if (typeof target === "string") {
-            target = PopsCore.document.querySelector(target);
+            target = this.selector(target);
         }
-        DOMUtilsContext.on(target, "keyup", null, handler, option);
+        const listener = this.on(target, "keyup", handler, option);
+        return listener;
     }
     /**
      * 当按键按下时触发事件
@@ -1225,14 +1256,14 @@ class PopsDOMUtilsEvent {
      * })
      */
     onKeydown(target, handler, option) {
-        const DOMUtilsContext = this;
         if (target == null) {
             return;
         }
         if (typeof target === "string") {
-            target = PopsCore.document.querySelector(target);
+            target = this.selector(target);
         }
-        DOMUtilsContext.on(target, "keydown", null, handler, option);
+        const listener = this.on(target, "keydown", handler, option);
+        return listener;
     }
     /**
      * 当按键按下时触发事件
@@ -1250,38 +1281,69 @@ class PopsDOMUtilsEvent {
      * })
      */
     onKeypress(target, handler, option) {
-        const DOMUtilsContext = this;
         if (target == null) {
             return;
         }
         if (typeof target === "string") {
-            target = PopsCore.document.querySelector(target);
+            target = this.selector(target);
         }
-        DOMUtilsContext.on(target, "keypress", null, handler, option);
+        const listener = this.on(target, "keypress", handler, option);
+        return listener;
     }
-    preventEvent(element, eventNameList = [], capture) {
-        function stopEvent(event) {
-            // 阻止事件的默认行为发生。例如，当点击一个链接时，浏览器会默认打开链接的URL
+    preventEvent(...args) {
+        /**
+         * 阻止事件的默认行为发生，并阻止事件传播
+         */
+        const stopEvent = (event, onlyStopPropagation) => {
+            if (typeof onlyStopPropagation === "boolean" && onlyStopPropagation) {
+                // 停止事件的传播，阻止它继续向更上层的元素冒泡，事件将不会再传播给其他的元素
+                event?.stopPropagation();
+                // 阻止事件传播，并且还能阻止元素上的其他事件处理程序被触发
+                event?.stopImmediatePropagation();
+                return;
+            }
+            // 阻止事件的默认行为发生。例如，当点击一个链接时，浏览器会默认打开链接的URL，或者在输入框内输入文字
             event?.preventDefault();
-            // 停止事件的传播，阻止它继续向更上层的元素冒泡，事件将不会再传播给其他的元素
-            event?.stopPropagation();
-            // 阻止事件传播，并且还能阻止元素上的其他事件处理程序被触发
-            event?.stopImmediatePropagation();
             return false;
-        }
-        if (arguments.length === 1) {
+        };
+        if (args[0] instanceof Event) {
             // 直接阻止事件
-            // eslint-disable-next-line prefer-rest-params
-            return stopEvent(arguments[0]);
+            const onlyStopPropagation = args[1];
+            return stopEvent(args[0], onlyStopPropagation);
         }
         else {
+            const $el = args[0];
+            let eventNameList = args[1];
+            let selector = void 0;
+            let capture = false;
+            let onlyStopPropagation = false;
             // 添加对应的事件来阻止触发
             if (typeof eventNameList === "string") {
                 eventNameList = [eventNameList];
             }
-            eventNameList.forEach((eventName) => {
-                this.on(element, eventName, stopEvent, { capture: Boolean(capture) });
-            });
+            let option = void 0;
+            if (typeof args[2] === "string" || Array.isArray(args[2])) {
+                // selector
+                selector = args[2];
+                if (typeof args[3] === "object" && args[3] != null) {
+                    option = args[3];
+                }
+            }
+            else if (typeof args[2] === "object" && args[2] != null && !Array.isArray(args[2])) {
+                // option
+                option = args[2];
+            }
+            else {
+                throw new TypeError("Invalid argument");
+            }
+            if (option) {
+                capture = Boolean(option.capture);
+                onlyStopPropagation = Boolean(option.onlyStopPropagation);
+            }
+            const listener = this.on($el, eventNameList, selector, (evt) => {
+                return stopEvent(evt, onlyStopPropagation);
+            }, { capture: capture });
+            return listener;
         }
     }
     selector(selector) {
@@ -1467,7 +1529,7 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
     width(element, isShow = false, parent) {
         const DOMUtilsContext = this;
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -1518,7 +1580,7 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
             return PopsCore.window.document.documentElement.clientHeight;
         }
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -1566,7 +1628,7 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
             return PopsCore.window.innerWidth;
         }
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -1591,7 +1653,7 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
             return PopsCore.window.innerHeight;
         }
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         element = element;
         if (isShow || (!isShow && popsDOMUtils.isShow(element))) {
@@ -2013,12 +2075,12 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
      * @param content 子元素或HTML字符串
      * @example
      * // 元素a.xx的内部末尾添加一个元素
-     * DOMUtils.append(document.querySelector("a.xx"),document.querySelector("b.xx"))
+     * DOMUtils.append(document.querySelector("a.xx"), document.querySelector("b.xx"))
      * DOMUtils.append("a.xx","'<b class="xx"></b>")
      * */
     append(element, content) {
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -2154,7 +2216,7 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
      * */
     before(element, content) {
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -2177,7 +2239,7 @@ class PopsDOMUtils extends PopsDOMUtilsEvent {
      * */
     after(element, content) {
         if (typeof element === "string") {
-            element = PopsCore.document.querySelector(element);
+            element = this.selector(element);
         }
         if (element == null) {
             return;
@@ -5828,7 +5890,7 @@ const PopsIframe = {
          */
         const $anim = PopsElementHandler.parseElement(animHTML);
         const { $pops: $pops, $headerBtnClose: headerCloseBtnElement, $headerControls: headerControlsElement, $title: $title, $iframe: $iframe, $loading: loadingElement, $contentLoading: $contentLoading, $headerBtnMin: headerMinBtnElement, $headerBtnMax: headerMaxBtnElement, $headerBtnMise: headerMiseBtnElement, } = PopsHandler.handleQueryElement($anim, popsType);
-        let $iframeContainer = PopsCore.document.querySelector(".pops-iframe-container");
+        let $iframeContainer = popsDOMUtils.selector(".pops-iframe-container");
         if (!$iframeContainer) {
             $iframeContainer = popsDOMUtils.createElement("div", {
                 className: "pops-iframe-container",
@@ -13306,7 +13368,7 @@ const PopsSearchSuggestion = {
     },
 };
 
-const version = "3.3.2";
+const version = "3.3.3";
 
 class Pops {
     /** 配置 */