ph-utils 0.12.3 → 0.12.5

package/lib/dom.d.ts

@@ -73,7 +73,7 @@ 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, option?: boolean | (AddEventListenerOptions & {
+export declare function on(element: HTMLElement | ShadowRoot | Document, listener: string, fn: EventListener, option?: boolean | (AddEventListenerOptions & {
     eventFlag?: string;
 })): void;
 /**
@@ -82,7 +82,7 @@ export declare function on<T extends Event>(element: HTMLElement, listener: stri
  * @param listener - 事件名称。
  * @param fn - 要移除的事件监听器函数。
  */
-export declare function off(el: HTMLElement | Document, listener: string, fn: EventListener, option?: boolean | EventListenerOptions): void;
+export declare function off(el: HTMLElement | ShadowRoot | Document, listener: string, fn: EventListener, option?: boolean | EventListenerOptions): void;
 /**
  * 判断事件是否应该继续传递。
  * 从事件目标开始向上遍历DOM树，检查每个节点上是否存在指定的属性。
@@ -92,9 +92,10 @@ export declare function off(el: HTMLElement | Document, listener: string, fn: Ev
  *
  * @param e - 触发的事件对象
  * @param eventFlag - 需要检查的属性名
+ * @param endRoot - 可选，如果传递该参数，则表示停止遍历的节点，如果未传递，则表示遍历到文档根节点为止
  * @returns 包含三个元素的数组：[是否继续传递事件, 属性值, 当前检查的DOM节点]
  */
-export declare function shouldEventNext(e: Event, eventFlag: string): (string | boolean | HTMLElement)[];
+export declare function shouldEventNext(e: Event, eventFlag: string, endRoot?: HTMLElement | ShadowRoot): [boolean, string, HTMLElement];
 /**
  * 设置或获取节点的 innerHTML 属性
  * @param element

package/lib/dom.js

@@ -125,7 +125,9 @@ export function toggleClass(el, clazz) {
  */
 export function on(element, listener, fn, option) {
     if (typeof option === "object" && option.eventFlag) {
-        element.setAttribute(option.eventFlag, "__stop__");
+        if (element.setAttribute) {
+            element.setAttribute(option.eventFlag, "__stop__");
+        }
     }
     element.addEventListener(listener, fn, option);
 }
@@ -147,20 +149,26 @@ export function off(el, listener, fn, option) {
  *
  * @param e - 触发的事件对象
  * @param eventFlag - 需要检查的属性名
+ * @param endRoot - 可选，如果传递该参数，则表示停止遍历的节点，如果未传递，则表示遍历到文档根节点为止
  * @returns 包含三个元素的数组：[是否继续传递事件, 属性值, 当前检查的DOM节点]
  */
-export function shouldEventNext(e, eventFlag) {
+export function shouldEventNext(e, eventFlag, endRoot) {
     let target = e.target;
     let flag = "";
     do {
-        flag = target.getAttribute(eventFlag) || "";
+        if ((endRoot && endRoot.isSameNode(target)) || target.tagName === "BODY") {
+            break;
+        }
+        if (target.getAttribute) {
+            flag = target.getAttribute(eventFlag) || "";
+        }
         if (flag === "") {
             target = target.parentNode;
-            if (!target)
-                break;
         }
+        if (!target)
+            break;
     } while (flag === "");
-    return [flag !== "__stop__", flag, target];
+    return [flag !== "__stop__" && flag !== "", flag, target];
 }
 /**
  * 设置或获取节点的 innerHTML 属性

package/package.json

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