@whitesev/domutils 1.8.9 → 1.9.0

package/dist/index.amd.js

@@ -1,6 +1,6 @@
 define((function () { 'use strict';
 
-  const version = "1.8.9";
+  const version = "1.9.0";
 
   class WindowApi {
       /** 默认的配置 */
@@ -311,9 +311,10 @@ define((function () { 'use strict';
        */
       matches($el, selector) {
           selector = selector.trim();
-          if ($el == null) {
+          if ($el == null)
+              return false;
+          if ($el instanceof Document)
               return false;
-          }
           if (selector.match(/[^\s]{1}:empty$/gi)) {
               // empty 语法
               selector = selector.replace(/:empty$/gi, "");
@@ -357,6 +358,10 @@ define((function () { 'use strict';
       }
       closest($el, selector) {
           selector = selector.trim();
+          if ($el == null)
+              return null;
+          if ($el instanceof Document)
+              return null;
           if (selector.match(/[^\s]{1}:empty$/gi)) {
               // empty 语法
               selector = selector.replace(/:empty$/gi, "");
@@ -1441,17 +1446,17 @@ define((function () { 'use strict';
           /**
            * 如果是once，那么删除该监听和元素上的事件和监听
            */
-          function checkOptionOnceToRemoveEventListener() {
+          const checkOptionOnceToRemoveEventListener = () => {
               if (listenerOption.once) {
                   that.off(element, eventType, selector, callback, option);
               }
-          }
+          };
           $elList.forEach((elementItem) => {
               /**
                * 事件回调
                * @param event
                */
-              function domUtilsEventCallBack(event) {
+              const handlerCallBack = function (event) {
                   if (selectorList.length) {
                       /* 存在子元素选择器 */
                       // 这时候的this和target都是子元素选择器的元素
@@ -1499,10 +1504,10 @@ define((function () { 'use strict';
                       listenerCallBack.call(elementItem, event);
                       checkOptionOnceToRemoveEventListener();
                   }
-              }
+              };
               /* 遍历事件名设置元素事件 */
               eventTypeList.forEach((eventName) => {
-                  elementItem.addEventListener(eventName, domUtilsEventCallBack, listenerOption);
+                  elementItem.addEventListener(eventName, handlerCallBack, listenerOption);
                   /* 获取对象上的事件 */
                   const elementEvents = Reflect.get(elementItem, GlobalData.domEventSymbol) || {};
                   /* 初始化对象上的xx事件 */
@@ -1510,8 +1515,8 @@ define((function () { 'use strict';
                   elementEvents[eventName].push({
                       selector: selectorList,
                       option: listenerOption,
-                      callback: domUtilsEventCallBack,
-                      originCallBack: listenerCallBack,
+                      handlerCallBack: handlerCallBack,
+                      callback: listenerCallBack,
                   });
                   /* 覆盖事件 */
                   Reflect.set(elementItem, GlobalData.domEventSymbol, elementEvents);
@@ -1527,11 +1532,11 @@ define((function () { 'use strict';
               },
               /**
                * 主动触发事件
-               * @param details 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
-               * @param useDispatchToEmit 是否使用dispatchEvent来触发事件，默认true，如果为false，则直接调用callback，但是这种会让使用了selectorTarget的没有值
+               * @param extraDetails 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
+               * @param useDispatchToTriggerEvent 是否使用dispatchEvent来触发事件，默认true，如果为false，则直接调用callback，但是这种会让使用了$selector的没有值
                */
-              emit: (details, useDispatchToEmit) => {
-                  that.emit($elList, eventTypeList, details, useDispatchToEmit);
+              emit: (extraDetails, useDispatchToTriggerEvent) => {
+                  that.emit($elList, eventTypeList, extraDetails, useDispatchToTriggerEvent);
               },
           };
       }
@@ -1627,7 +1632,7 @@ define((function () { 'use strict';
                   for (let index = 0; index < filterHandler.length; index++) {
                       const handler = filterHandler[index];
                       let flag = true;
-                      if (flag && listenerCallBack && handler.originCallBack !== listenerCallBack) {
+                      if (flag && listenerCallBack && handler.callback !== listenerCallBack) {
                           // callback不同
                           flag = false;
                       }
@@ -1644,7 +1649,7 @@ define((function () { 'use strict';
                           flag = false;
                       }
                       if (flag || isRemoveAll) {
-                          $elItem.removeEventListener(eventName, handler.callback, handler.option);
+                          $elItem.removeEventListener(eventName, handler.handlerCallBack, handler.option);
                           const findIndex = handlers.findIndex((item) => item === handler);
                           if (findIndex !== -1) {
                               handlers.splice(findIndex, 1);
@@ -1700,7 +1705,7 @@ define((function () { 'use strict';
                           return;
                       }
                       for (const handler of handlers) {
-                          $elItem.removeEventListener(eventName, handler.callback, {
+                          $elItem.removeEventListener(eventName, handler.handlerCallBack, {
                               capture: handler["option"]["capture"],
                           });
                       }
@@ -1803,8 +1808,8 @@ define((function () { 'use strict';
        * 主动触发事件
        * @param element 需要触发的元素|元素数组|window
        * @param eventType 需要触发的事件
-       * @param details 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
-       * @param useDispatchToEmit 是否使用dispatchEvent来触发事件，默认true，如果为false，则直接调用callback，但是这种会让使用了selectorTarget的没有值
+       * @param extraDetails 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
+       * @param useDispatchToTriggerEvent 是否使用dispatchEvent来触发事件，默认true，如果为false，则直接调用通过.on监听的callback()，但是这种只有一个入参，如果使用$selector则没有值
        * @example
        * // 触发元素a.xx的click事件
        * DOMUtils.emit(document.querySelector("a.xx"),"click")
@@ -1813,7 +1818,7 @@ define((function () { 'use strict';
        * DOMUtils.emit(document.querySelector("a.xx"),"click tap hover")
        * DOMUtils.emit("a.xx",["click","tap","hover"])
        */
-      emit(element, eventType, details, useDispatchToEmit = true) {
+      emit(element, eventType, extraDetails, useDispatchToTriggerEvent = true) {
           const that = this;
           if (typeof element === "string") {
               element = that.selectorAll(element);
@@ -1840,25 +1845,25 @@ define((function () { 'use strict';
               const elementEvents = Reflect.get($elItem, GlobalData.domEventSymbol) || {};
               eventTypeList.forEach((eventTypeItem) => {
                   let event = null;
-                  if (details && details instanceof Event) {
-                      event = details;
+                  if (extraDetails && extraDetails instanceof Event) {
+                      event = extraDetails;
                   }
                   else {
                       // 构造事件
                       event = new Event(eventTypeItem);
-                      if (details) {
-                          const detailKeys = Object.keys(details);
+                      if (typeof extraDetails === "object" && extraDetails != null) {
+                          const detailKeys = Object.keys(extraDetails);
                           detailKeys.forEach((keyName) => {
-                              const value = Reflect.get(details, keyName);
+                              const value = Reflect.get(extraDetails, keyName);
                               // 在event上添加属性
                               Reflect.set(event, keyName, value);
                           });
                       }
                   }
-                  if (useDispatchToEmit == false && eventTypeItem in elementEvents) {
+                  if (useDispatchToTriggerEvent == false && eventTypeItem in elementEvents) {
                       // 直接调用监听的事件
                       elementEvents[eventTypeItem].forEach((eventsItem) => {
-                          eventsItem.callback(event);
+                          eventsItem.handlerCallBack(event);
                       });
                   }
                   else {
@@ -2344,14 +2349,14 @@ define((function () { 'use strict';
                   isDoubleClick: true,
               });
           }, options);
-          const touchEndListener = this.on($el, "pointerup", selector, (evt, selectorTarget) => {
+          const touchEndListener = this.on($el, "pointerup", selector, (evt, $selector) => {
               this.preventEvent(evt);
               if (evt.pointerType === "touch") {
                   isMobileTouch = true;
               }
               clearTimeout(timer);
               timer = void 0;
-              if (isDoubleClick && $click === selectorTarget) {
+              if (isDoubleClick && $click === $selector) {
                   isDoubleClick = false;
                   $click = null;
                   /* 判定为双击 */
@@ -2368,7 +2373,7 @@ define((function () { 'use strict';
                       });
                   }, checkClickTime);
                   isDoubleClick = true;
-                  $click = selectorTarget;
+                  $click = $selector;
               }
           }, options);
           return {
@@ -3915,6 +3920,10 @@ define((function () { 'use strict';
       }
   }
   const domUtils = new DOMUtils();
+  domUtils.emit(document, "test");
+  domUtils.emit(document, "click");
+  domUtils.emit(document, ["test", "click"]);
+  domUtils.emit(document, ["test", "click"], true);
 
   return domUtils;