@whitesev/domutils 2.0.1 → 2.0.3

package/src/ElementEvent.ts

@@ -1,6 +1,7 @@
 import { CommonUtils } from "./CommonUtils";
 import { ElementAnimate } from "./ElementAnimate";
 import { GlobalData } from "./GlobalData";
+import { OriginPrototype } from "./OriginPrototype";
 import type {
   DOMUtils_Event,
   DOMUtils_EventType,
@@ -177,12 +178,14 @@ class ElementEvent extends ElementAnimate {
         ("capture" in currentParam ||
           "once" in currentParam ||
           "passive" in currentParam ||
-          "isComposedPath" in currentParam)
+          "isComposedPath" in currentParam ||
+          "overrideTarget" in currentParam)
       ) {
         option.capture = currentParam.capture;
         option.once = currentParam.once;
         option.passive = currentParam.passive;
         option.isComposedPath = currentParam.isComposedPath;
+        option.overrideTarget = currentParam.overrideTarget;
       }
       return option;
     };
@@ -231,6 +234,7 @@ class ElementEvent extends ElementAnimate {
       once: false,
       passive: false,
       isComposedPath: false,
+      overrideTarget: true,
     };
     if (typeof selector === "function") {
       // 这是为没有selector的情况
@@ -294,8 +298,25 @@ class ElementEvent extends ElementAnimate {
               return false;
             });
             if (findValue) {
-              // 这里尝试使用defineProperty修改event的target值
-              // 不建议使用覆盖target，因为可能会有兼容性问题
+              if (listenerOption.overrideTarget) {
+                // 这里尝试使用defineProperty修改event的target值
+                try {
+                  const originTarget = event.target;
+                  OriginPrototype.Object.defineProperty(event, "target", {
+                    value: $target,
+                    get() {
+                      return $target;
+                    },
+                  });
+                  OriginPrototype.Object.defineProperty(event, "originTarget", {
+                    value: $target,
+                    get() {
+                      return originTarget;
+                    },
+                  });
+                  // oxlint-disable-next-line no-empty
+                } catch {}
+              }
               execCallback = true;
               call_this = $target;
               call_event = event;
@@ -1456,6 +1477,12 @@ class ElementEvent extends ElementAnimate {
     options?: DOMUtilsDoubleEventEventListenerOption | boolean
   ): {
     off(): void;
+    /**
+     * 主动触发事件
+     * @param event 事件
+     * @param option 配置，如果不传入配置，则默认`isDouble`固定为false
+     */
+    emit(event: Event, option?: DOMUtilsDoubleEventOption): void;
   };
   /**
    * 监听事件单/双次触发
@@ -1475,9 +1502,21 @@ class ElementEvent extends ElementAnimate {
     options?: DOMUtilsDoubleEventEventListenerOption | boolean
   ): {
     off(): void;
+    /**
+     * 主动触发事件
+     * @param event 事件
+     * @param option 配置，如果不传入配置，则默认`isDouble`固定为false
+     */
+    emit(event: Event, option?: DOMUtilsDoubleEventOption): void;
   };
   onOneOrDouble(...args: any[]): {
     off(): void;
+    /**
+     * 主动触发事件
+     * @param event 事件
+     * @param option 配置，如果不传入配置，则默认`isDouble`固定为false
+     */
+    emit(event: Event, option?: DOMUtilsDoubleEventOption): void;
   } {
     const $el: DOMUtilsElementEventType = args[0];
     let selector: string | string[] | undefined | null = void 0;
@@ -1571,6 +1610,14 @@ class ElementEvent extends ElementAnimate {
         // @ts-expect-error
         eventNodeMap = null;
       },
+      emit(event, option) {
+        callback(
+          event,
+          option || {
+            isDouble: false,
+          }
+        );
+      },
     };
   }
   /**

package/src/types/DOMUtilsEvent.d.ts

@@ -372,6 +372,13 @@ export declare type DOMUtilsEventListenerOption = AddEventListenerOptions & {
    * @default false
    */
   isComposedPath?: boolean;
+  /**
+   * 是否覆写`target`，仅传入了子元素的`selectorTarget`时才会生效
+   *
+   * 原始的`target`将命名为`originTarget`
+   * @default true
+   */
+  overrideTarget?: boolean;
 };
 export declare type DOMUtilsElementEventType =
   | HTMLElement