@whitesev/domutils 1.9.5 → 1.9.7

package/dist/index.umd.js

@@ -4,7 +4,7 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.DOMUtils = factory());
 })(this, (function () { 'use strict';
 
-  const version = "1.9.5";
+  const version = "1.9.6";
 
   class WindowApi {
       /** 默认的配置 */
@@ -594,10 +594,7 @@
                   "slideDown",
                   "slideToggle",
                   "slideUp",
-                  "sort",
-                  "splice",
                   "text",
-                  "toArray",
                   "toggle",
                   "toggleClass",
                   "trigger",
@@ -1863,35 +1860,43 @@
           else {
               $elList.push(element);
           }
+          /**
+           * 主动添加属性
+           */
+          const addExtraProp = (event, obj) => {
+              if (event instanceof Event && typeof obj === "object" && obj != null && !Array.isArray(obj)) {
+                  const detailKeys = Object.keys(obj);
+                  detailKeys.forEach((keyName) => {
+                      const value = Reflect.get(obj, keyName);
+                      // 在event上添加属性
+                      Reflect.set(event, keyName, value);
+                  });
+              }
+          };
           let eventTypeList = [];
+          /**
+           * 主动传递的事件
+           */
+          let __event__ = null;
           if (Array.isArray(eventType)) {
               eventTypeList = eventType.filter((it) => typeof it === "string" && it.trim() !== "");
           }
           else if (typeof eventType === "string") {
               eventTypeList = eventType.split(" ");
           }
+          else if (eventType instanceof Event) {
+              __event__ = eventType;
+              addExtraProp(__event__, extraDetails);
+          }
           $elList.forEach(($elItem) => {
               /* 获取对象上的事件 */
               const elementEvents = Reflect.get($elItem, GlobalData.domEventSymbol) || {};
-              eventTypeList.forEach((eventTypeItem) => {
-                  let event = null;
-                  if (extraDetails && extraDetails instanceof Event) {
-                      event = extraDetails;
-                  }
-                  else {
-                      // 构造事件
-                      event = new Event(eventTypeItem);
-                      if (typeof extraDetails === "object" && extraDetails != null) {
-                          const detailKeys = Object.keys(extraDetails);
-                          detailKeys.forEach((keyName) => {
-                              const value = Reflect.get(extraDetails, keyName);
-                              // 在event上添加属性
-                              Reflect.set(event, keyName, value);
-                          });
-                      }
-                  }
+              /**
+               * 触发事件
+               */
+              const dispatchEvent = (event, eventTypeItem) => {
                   if (useDispatchToTriggerEvent == false && eventTypeItem in elementEvents) {
-                      // 直接调用监听的事件
+                      // 直接调用.on监听的事件
                       elementEvents[eventTypeItem].forEach((eventsItem) => {
                           eventsItem.handlerCallBack(event);
                       });
@@ -1899,7 +1904,21 @@
                   else {
                       $elItem.dispatchEvent(event);
                   }
-              });
+              };
+              if (__event__) {
+                  // 使用主动传递的事件直接触发
+                  const event = __event__;
+                  const eventTypeItem = event.type;
+                  dispatchEvent(event, eventTypeItem);
+              }
+              else {
+                  eventTypeList.forEach((eventTypeItem) => {
+                      // 构造事件
+                      const event = new Event(eventTypeItem);
+                      addExtraProp(event, extraDetails);
+                      dispatchEvent(event, eventTypeItem);
+                  });
+              }
           });
       }
       /**
@@ -1935,7 +1954,8 @@
               that.emit(element, "click", details, useDispatchToEmit);
           }
           else {
-              that.on(element, "click", null, handler);
+              const listener = that.on(element, "click", null, handler);
+              return listener;
           }
       }
       /**
@@ -1971,7 +1991,8 @@
               that.emit(element, "blur", details, useDispatchToEmit);
           }
           else {
-              that.on(element, "blur", null, handler);
+              const listener = that.on(element, "blur", null, handler);
+              return listener;
           }
       }
       /**
@@ -2007,7 +2028,8 @@
               that.emit(element, "focus", details, useDispatchToEmit);
           }
           else {
-              that.on(element, "focus", null, handler);
+              const listener = that.on(element, "focus", null, handler);
+              return listener;
           }
       }
       /**
@@ -2034,13 +2056,30 @@
           }
           if (CommonUtils.isNodeList(element)) {
               // 设置
+              const listenerList = [];
               element.forEach(($ele) => {
-                  that.onHover($ele, handler, option);
+                  const listener = that.onHover($ele, handler, option);
+                  listenerList.push(listener);
               });
-              return;
+              return {
+                  off() {
+                      listenerList.forEach((listener) => {
+                          if (!listener) {
+                              return;
+                          }
+                          listener.off();
+                      });
+                  },
+              };
           }
-          that.on(element, "mouseenter", null, handler, option);
-          that.on(element, "mouseleave", null, handler, option);
+          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();
+              },
+          };
       }
       /**
        * 监听动画结束
@@ -2123,12 +2162,23 @@
           }
           if (CommonUtils.isNodeList(element)) {
               // 设置
+              const listenerList = [];
               element.forEach(($ele) => {
-                  that.onKeyup($ele, handler, option);
+                  const listener = that.onKeyup($ele, handler, option);
+                  listenerList.push(listener);
               });
-              return;
+              return {
+                  off() {
+                      listenerList.forEach((listener) => {
+                          if (!listener) {
+                              return;
+                          }
+                          listener.off();
+                      });
+                  },
+              };
           }
-          that.on(element, "keyup", null, handler, option);
+          return that.on(element, "keyup", null, handler, option);
       }
       /**
        * 当按键按下时触发事件
@@ -2155,12 +2205,23 @@
           }
           if (CommonUtils.isNodeList(element)) {
               // 设置
+              const listenerList = [];
               element.forEach(($ele) => {
-                  that.onKeydown($ele, handler, option);
+                  const listener = that.onKeydown($ele, handler, option);
+                  listenerList.push(listener);
               });
-              return;
+              return {
+                  off() {
+                      listenerList.forEach((listener) => {
+                          if (!listener) {
+                              return;
+                          }
+                          listener.off();
+                      });
+                  },
+              };
           }
-          that.on(element, "keydown", null, handler, option);
+          return that.on(element, "keydown", null, handler, option);
       }
       /**
        * 当按键按下时触发事件
@@ -2187,12 +2248,23 @@
           }
           if (CommonUtils.isNodeList(element)) {
               // 设置
+              const listenerList = [];
               element.forEach(($ele) => {
-                  that.onKeypress($ele, handler, option);
+                  const listener = that.onKeypress($ele, handler, option);
+                  listenerList.push(listener);
               });
-              return;
+              return {
+                  off() {
+                      listenerList.forEach((listener) => {
+                          if (!listener) {
+                              return;
+                          }
+                          listener.off();
+                      });
+                  },
+              };
           }
-          that.on(element, "keypress", null, handler, option);
+          return that.on(element, "keypress", null, handler, option);
       }
       /**
        * 监听某个元素键盘按键事件或window全局按键事件
@@ -2285,12 +2357,8 @@
                   handler(keyName, keyValue, otherCodeList, event);
               }
           };
-          that.on(element, eventName, keyboardEventCallBack, options);
-          return {
-              removeListen: () => {
-                  that.off(element, eventName, keyboardEventCallBack, options);
-              },
-          };
+          const listener = that.on(element, eventName, keyboardEventCallBack, options);
+          return listener;
       }
       /**
        * 监input、textarea的输入框值改变的事件（当输入法输入时，不会触发该监听）
@@ -2321,11 +2389,14 @@
           const compositionStartListener = this.on($el, "compositionstart", __composition_start_callback, option);
           const compositionEndListener = this.on($el, "compositionend", __composition_end_callback, option);
           return {
-              off: () => {
+              off() {
                   inputListener.off();
                   compositionStartListener.off();
                   compositionEndListener.off();
               },
+              emit(details, useDispatchToEmit) {
+                  inputListener.emit(details, useDispatchToEmit);
+              },
           };
       }
       onDoubleClick(...args) {
@@ -2408,28 +2479,56 @@
           /**
            * 阻止事件的默认行为发生，并阻止事件传播
            */
-          const stopEvent = (event) => {
-              /* 阻止事件的默认行为发生。例如，当点击一个链接时，浏览器会默认打开链接的URL */
+          const stopEvent = (event, onlyStopPropagation) => {
+              if (typeof onlyStopPropagation === "boolean" && onlyStopPropagation) {
+                  // 停止事件的传播，阻止它继续向更上层的元素冒泡，事件将不会再传播给其他的元素
+                  event?.stopPropagation();
+                  // 阻止事件传播，并且还能阻止元素上的其他事件处理程序被触发
+                  event?.stopImmediatePropagation();
+                  return;
+              }
+              // 阻止事件的默认行为发生。例如，当点击一个链接时，浏览器会默认打开链接的URL，或者在输入框内输入文字
               event?.preventDefault();
-              /* 停止事件的传播，阻止它继续向更上层的元素冒泡，事件将不会再传播给其他的元素 */
-              event?.stopPropagation();
-              /* 阻止事件传播，并且还能阻止元素上的其他事件处理程序被触发 */
-              event?.stopImmediatePropagation();
               return false;
           };
-          if (args.length === 1) {
-              /* 直接阻止事件 */
-              return stopEvent(args[0]);
+          if (args[0] instanceof Event) {
+              // 直接阻止事件
+              const onlyStopPropagation = args[1];
+              return stopEvent(args[0], onlyStopPropagation);
           }
           else {
               const $el = args[0];
               let eventNameList = args[1];
-              const capture = args[2];
-              /* 添加对应的事件来阻止触发 */
+              let selector = void 0;
+              let capture = false;
+              let onlyStopPropagation = false;
+              // 添加对应的事件来阻止触发
               if (typeof eventNameList === "string") {
                   eventNameList = [eventNameList];
               }
-              this.on($el, eventNameList, 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;
           }
       }
   }