@whitesev/domutils 1.4.5 → 1.4.7

package/dist/types/src/DOMUtilsEvent.d.ts

@@ -67,7 +67,7 @@ export declare class DOMUtilsEvent {
      *    console.log("事件触发",event)
      * })
      */
-    on<T extends DOMUtils_EventType>(element: DOMUtilsElementEventType, eventType: T | T[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: DOMUtils_Event[T]) => void, option?: DOMUtilsEventListenerOption | boolean): void;
+    on<T extends DOMUtils_EventType>(element: DOMUtilsElementEventType, eventType: T | T[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: DOMUtils_Event[T], selectorTarget: HTMLElement) => void, option?: DOMUtilsEventListenerOption | boolean): void;
     /**
      * 绑定事件
      * @param element 需要绑定的元素|元素数组|window
@@ -92,7 +92,7 @@ export declare class DOMUtilsEvent {
      *    console.log("事件触发",event)
      * })
      */
-    on<T extends Event>(element: DOMUtilsElementEventType, eventType: string, selector: string | string[] | (() => string | string[]) | undefined | null, callback: (this: HTMLElement, event: T) => void, option?: DOMUtilsEventListenerOption | boolean): void;
+    on<T extends Event>(element: DOMUtilsElementEventType, eventType: string, selector: string | string[] | (() => string | string[]) | undefined | null, callback: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: DOMUtilsEventListenerOption | boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -106,7 +106,7 @@ export declare class DOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click")
      * DOMUtils.off("a.xx","click")
      */
-    off<T extends DOMUtils_EventType>(element: DOMUtilsElementEventType, eventType: T | T[], callback?: (this: HTMLElement, event: DOMUtils_Event[T]) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends DOMUtils_EventType>(element: DOMUtilsElementEventType, eventType: T | T[], callback?: (this: HTMLElement, event: DOMUtils_Event[T], selectorTarget: HTMLElement) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -120,7 +120,7 @@ export declare class DOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click")
      * DOMUtils.off("a.xx","click")
      */
-    off<T extends Event>(element: DOMUtilsElementEventType, eventType: string, callback?: (this: HTMLElement, event: T) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends Event>(element: DOMUtilsElementEventType, eventType: string, callback?: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -135,7 +135,7 @@ export declare class DOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click tap hover")
      * DOMUtils.off("a.xx",["click","tap","hover"])
      */
-    off<T extends DOMUtils_EventType>(element: DOMUtilsElementEventType, eventType: T | T[], selector?: DOMUtilsEventListenerOptionsAttribute["selector"] | undefined, callback?: (this: HTMLElement, event: DOMUtils_Event[T]) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends DOMUtils_EventType>(element: DOMUtilsElementEventType, eventType: T | T[], selector?: DOMUtilsEventListenerOptionsAttribute["selector"] | undefined, callback?: (this: HTMLElement, event: DOMUtils_Event[T], selectorTarget: HTMLElement) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -150,7 +150,7 @@ export declare class DOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click tap hover")
      * DOMUtils.off("a.xx",["click","tap","hover"])
      */
-    off<T extends Event>(element: DOMUtilsElementEventType, eventType: string, selector?: DOMUtilsEventListenerOptionsAttribute["selector"] | undefined, callback?: (this: HTMLElement, event: T) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends Event>(element: DOMUtilsElementEventType, eventType: string, selector?: DOMUtilsEventListenerOptionsAttribute["selector"] | undefined, callback?: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: boolean | EventListenerOptions, filter?: (value: DOMUtilsEventListenerOptionsAttribute, index: number, array: DOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定所有的事件
      * @param element 需要取消绑定的元素|元素数组

package/dist/types/src/types/DOMUtilsEvent.d.ts

@@ -215,7 +215,7 @@ export declare interface DOMUtilsEventListenerOptionsAttribute {
 	/**
 	 * 用户添加的事件
 	 */
-	originCallBack: (event: Event) => void;
+	originCallBack: (event: Event, selectorTarget?: HTMLElement) => void;
 	/**
 	 * 子元素选择器
 	 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/domutils",
-  "version": "1.4.5",
+  "version": "1.4.7",
   "description": "使用js重新对jQuery的部分函数进行了仿写",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/src/DOMUtilsEvent.ts

@@ -94,7 +94,11 @@ export class DOMUtilsEvent {
 		element: DOMUtilsElementEventType,
 		eventType: T | T[],
 		selector: string | string[] | undefined | null,
-		callback: (this: HTMLElement, event: DOMUtils_Event[T]) => void,
+		callback: (
+			this: HTMLElement,
+			event: DOMUtils_Event[T],
+			selectorTarget: HTMLElement
+		) => void,
 		option?: DOMUtilsEventListenerOption | boolean
 	): void;
 	/**
@@ -125,7 +129,11 @@ export class DOMUtilsEvent {
 		element: DOMUtilsElementEventType,
 		eventType: string,
 		selector: string | string[] | (() => string | string[]) | undefined | null,
-		callback: (this: HTMLElement, event: T) => void,
+		callback: (
+			this: HTMLElement,
+			event: T,
+			selectorTarget: HTMLElement
+		) => void,
 		option?: DOMUtilsEventListenerOption | boolean
 	): void;
 	on<T extends Event>(
@@ -144,10 +152,10 @@ export class DOMUtilsEvent {
 			| string
 			| undefined
 			| string[]
-			| ((this: HTMLElement, event: T) => void)
+			| ((this: HTMLElement, event: T, selectorTarget: HTMLElement) => void)
 			| null,
 		callback?:
-			| ((this: HTMLElement, event: T) => void)
+			| ((this: HTMLElement, event: T, selectorTarget: HTMLElement) => void)
 			| DOMUtilsEventListenerOption
 			| boolean,
 		option?: DOMUtilsEventListenerOption | boolean
@@ -217,8 +225,11 @@ export class DOMUtilsEvent {
 			selectorList.push(selector);
 		}
 		// 事件回调
-		let listenerCallBack: (this: HTMLElement, event: Event) => void =
-			callback as any;
+		let listenerCallBack: (
+			this: HTMLElement,
+			event: Event,
+			selectorTarget?: HTMLElement
+		) => void = callback as any;
 		// 事件配置
 		let listenerOption: DOMUtilsEventListenerOption = {
 			capture: false,
@@ -266,7 +277,7 @@ export class DOMUtilsEvent {
 						const selectorItem = selectorList[index];
 						if (eventTarget.matches(selectorItem)) {
 							/* 当前目标可以被selector所匹配到 */
-							listenerCallBack.call(eventTarget, event as any);
+							listenerCallBack.call(eventTarget, event as any, eventTarget);
 							checkOptionOnceToRemoveEventListener();
 							break;
 						} else {
@@ -284,7 +295,11 @@ export class DOMUtilsEvent {
 										},
 									});
 								} catch (error) {}
-								listenerCallBack.call($closestMatches, event as any);
+								listenerCallBack.call(
+									$closestMatches,
+									event as any,
+									$closestMatches
+								);
 								checkOptionOnceToRemoveEventListener();
 								break;
 							}
@@ -338,7 +353,11 @@ export class DOMUtilsEvent {
 	off<T extends DOMUtils_EventType>(
 		element: DOMUtilsElementEventType,
 		eventType: T | T[],
-		callback?: (this: HTMLElement, event: DOMUtils_Event[T]) => void,
+		callback?: (
+			this: HTMLElement,
+			event: DOMUtils_Event[T],
+			selectorTarget: HTMLElement
+		) => void,
 		option?: boolean | EventListenerOptions,
 		filter?: (
 			value: DOMUtilsEventListenerOptionsAttribute,
@@ -362,7 +381,11 @@ export class DOMUtilsEvent {
 	off<T extends Event>(
 		element: DOMUtilsElementEventType,
 		eventType: string,
-		callback?: (this: HTMLElement, event: T) => void,
+		callback?: (
+			this: HTMLElement,
+			event: T,
+			selectorTarget: HTMLElement
+		) => void,
 		option?: boolean | EventListenerOptions,
 		filter?: (
 			value: DOMUtilsEventListenerOptionsAttribute,
@@ -388,7 +411,11 @@ export class DOMUtilsEvent {
 		element: DOMUtilsElementEventType,
 		eventType: T | T[],
 		selector?: DOMUtilsEventListenerOptionsAttribute["selector"] | undefined,
-		callback?: (this: HTMLElement, event: DOMUtils_Event[T]) => void,
+		callback?: (
+			this: HTMLElement,
+			event: DOMUtils_Event[T],
+			selectorTarget: HTMLElement
+		) => void,
 		option?: boolean | EventListenerOptions,
 		filter?: (
 			value: DOMUtilsEventListenerOptionsAttribute,
@@ -414,7 +441,11 @@ export class DOMUtilsEvent {
 		element: DOMUtilsElementEventType,
 		eventType: string,
 		selector?: DOMUtilsEventListenerOptionsAttribute["selector"] | undefined,
-		callback?: (this: HTMLElement, event: T) => void,
+		callback?: (
+			this: HTMLElement,
+			event: T,
+			selectorTarget: HTMLElement
+		) => void,
 		option?: boolean | EventListenerOptions,
 		filter?: (
 			value: DOMUtilsEventListenerOptionsAttribute,
@@ -437,9 +468,9 @@ export class DOMUtilsEvent {
 		selector?:
 			| DOMUtilsEventListenerOptionsAttribute["selector"]
 			| undefined
-			| ((this: HTMLElement, event: T) => void),
+			| ((this: HTMLElement, event: T, selectorTarget: HTMLElement) => void),
 		callback?:
-			| ((this: HTMLElement, event: T) => void)
+			| ((this: HTMLElement, event: T, selectorTarget: HTMLElement) => void)
 			| boolean
 			| EventListenerOptions,
 		option?:
@@ -509,8 +540,11 @@ export class DOMUtilsEvent {
 		/**
 		 * 事件的回调函数
 		 */
-		let listenerCallBack: (this: HTMLElement, event: T) => void =
-			callback as any;
+		let listenerCallBack: (
+			this: HTMLElement,
+			event: T,
+			selectorTarget: HTMLElement
+		) => void = callback as any;
 
 		/**
 		 * 事件的配置

package/src/types/DOMUtilsEvent.d.ts

@@ -215,7 +215,7 @@ export declare interface DOMUtilsEventListenerOptionsAttribute {
 	/**
 	 * 用户添加的事件
 	 */
-	originCallBack: (event: Event) => void;
+	originCallBack: (event: Event, selectorTarget?: HTMLElement) => void;
 	/**
 	 * 子元素选择器
 	 */