ph-utils 0.12.1 → 0.12.2

package/lib/dom.d.ts

@@ -76,7 +76,6 @@ export declare function toggleClass(el: HTMLElement, clazz: string): void;
 export declare function on<T extends Event>(element: HTMLElement, listener: string, fn: (e: T, target?: HTMLElement, flag?: string) => void, once?: boolean | {
     once?: boolean;
     eventFlag?: string;
-    eventStop?: boolean;
     capture?: boolean;
 }): void;
 /**
@@ -86,6 +85,18 @@ export declare function on<T extends Event>(element: HTMLElement, listener: stri
  * @param fn - 要移除的事件监听器函数。
  */
 export declare function off(el: HTMLElement, listener: string, fn: EventListener): void;
+/**
+ * 判断事件是否应该继续传递。
+ * 从事件目标开始向上遍历DOM树，检查每个节点上是否存在指定的属性。
+ * 如果找到该属性且其值不为'__stop__'，则返回true，表示事件可以继续传递。
+ * 否则，返回false，表示事件应该停止传递。
+ * 通常用于事件委托时判断是否继续传递事件。
+ *
+ * @param e - 触发的事件对象
+ * @param eventFlag - 需要检查的属性名
+ * @returns 包含三个元素的数组：[是否继续传递事件, 属性值, 当前检查的DOM节点]
+ */
+export declare function shouldEventNext(e: Event, eventFlag: string): (string | boolean | HTMLElement)[];
 /**
  * 设置或获取节点的 innerHTML 属性
  * @param element

package/lib/dom.js

@@ -124,7 +124,7 @@ export function toggleClass(el, clazz) {
  * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
 export function on(element, listener, fn, once = false) {
-    let eventExtra = { eventStop: false };
+    let eventExtra = {};
     if (typeof once === "boolean") {
         eventExtra.once = once;
     }
@@ -133,23 +133,8 @@ export function on(element, listener, fn, once = false) {
     }
     if (eventExtra.eventFlag != null) {
         element.setAttribute(eventExtra.eventFlag, "__stop__");
-        element.addEventListener(listener, (e) => {
-            let target = e.target;
-            let flag = "";
-            do {
-                flag = target.getAttribute(eventExtra.eventFlag) || "";
-                if (flag === "") {
-                    target = target.parentNode;
-                }
-            } while (flag === "");
-            if (flag !== "__stop__" || eventExtra.eventStop) {
-                fn(e, target, flag);
-            }
-        }, eventExtra);
-    }
-    else {
-        element.addEventListener(listener, fn, eventExtra);
     }
+    element.addEventListener(listener, fn, eventExtra);
 }
 /**
  * 移除指定元素的事件监听器。
@@ -160,6 +145,28 @@ export function on(element, listener, fn, once = false) {
 export function off(el, listener, fn) {
     el.removeEventListener(listener, fn);
 }
+/**
+ * 判断事件是否应该继续传递。
+ * 从事件目标开始向上遍历DOM树，检查每个节点上是否存在指定的属性。
+ * 如果找到该属性且其值不为'__stop__'，则返回true，表示事件可以继续传递。
+ * 否则，返回false，表示事件应该停止传递。
+ * 通常用于事件委托时判断是否继续传递事件。
+ *
+ * @param e - 触发的事件对象
+ * @param eventFlag - 需要检查的属性名
+ * @returns 包含三个元素的数组：[是否继续传递事件, 属性值, 当前检查的DOM节点]
+ */
+export function shouldEventNext(e, eventFlag) {
+    let target = e.target;
+    let flag = "";
+    do {
+        flag = target.getAttribute(eventFlag) || "";
+        if (flag === "") {
+            target = target.parentNode;
+        }
+    } while (flag === "");
+    return [flag !== "__stop__", flag, target];
+}
 /**
  * 设置或获取节点的 innerHTML 属性
  * @param element

package/package.json

@@ -68,7 +68,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.12.1",
+  "version": "0.12.2",
   "type": "module",
   "repository": {
     "type": "git",