ph-utils 0.12.1 → 0.12.3

package/lib/dom.d.ts

@@ -73,19 +73,28 @@ export declare function toggleClass(el: HTMLElement, clazz: string): void;
  * @param {function}    event     事件处理函数
  * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
-export declare function on<T extends Event>(element: HTMLElement, listener: string, fn: (e: T, target?: HTMLElement, flag?: string) => void, once?: boolean | {
-    once?: boolean;
+export declare function on<T extends Event>(element: HTMLElement, listener: string, fn: (e: T, target?: HTMLElement, flag?: string) => void, option?: boolean | (AddEventListenerOptions & {
     eventFlag?: string;
-    eventStop?: boolean;
-    capture?: boolean;
-}): void;
+})): void;
 /**
  * 移除指定元素的事件监听器。
  * @param el - 要移除监听器的 HTML 元素。
  * @param listener - 事件名称。
  * @param fn - 要移除的事件监听器函数。
  */
-export declare function off(el: HTMLElement, listener: string, fn: EventListener): void;
+export declare function off(el: HTMLElement | Document, listener: string, fn: EventListener, option?: boolean | EventListenerOptions): 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

@@ -123,33 +123,11 @@ export function toggleClass(el, clazz) {
  * @param {function}    event     事件处理函数
  * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
-export function on(element, listener, fn, once = false) {
-    let eventExtra = { eventStop: false };
-    if (typeof once === "boolean") {
-        eventExtra.once = once;
-    }
-    else {
-        eventExtra = once;
-    }
-    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);
+export function on(element, listener, fn, option) {
+    if (typeof option === "object" && option.eventFlag) {
+        element.setAttribute(option.eventFlag, "__stop__");
     }
+    element.addEventListener(listener, fn, option);
 }
 /**
  * 移除指定元素的事件监听器。
@@ -157,8 +135,32 @@ export function on(element, listener, fn, once = false) {
  * @param listener - 事件名称。
  * @param fn - 要移除的事件监听器函数。
  */
-export function off(el, listener, fn) {
-    el.removeEventListener(listener, fn);
+export function off(el, listener, fn, option) {
+    el.removeEventListener(listener, fn, option);
+}
+/**
+ * 判断事件是否应该继续传递。
+ * 从事件目标开始向上遍历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;
+            if (!target)
+                break;
+        }
+    } while (flag === "");
+    return [flag !== "__stop__", flag, target];
 }
 /**
  * 设置或获取节点的 innerHTML 属性

package/package.json

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