@whitesev/pops 4.1.0 → 4.2.1

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

@@ -17,6 +17,7 @@ declare class Pops {
     config: {
         /** 版本号 */
         version: string;
+        /** 样式配置 */
         cssText: {
             index: string;
             ninePalaceGridPosition: string;
@@ -84,10 +85,9 @@ declare class Pops {
             panel: import("./types/inst").PopsInstGeneralConfig[];
             rightClickMenu: import("./types/inst").PopsInstGeneralConfig[];
         };
-        /** 禁止滚动 */
-        forbiddenScroll: {
-            event(event: Event): false;
-        };
+    };
+    /** 导出的函数 */
+    fn: {
         /** pops使用的工具类 */
         Utils: {
             sleep(timeout: number): Promise<unknown>;
@@ -134,7 +134,6 @@ declare class Pops {
         DOMUtils: {
             getAnimationEndNameList(): string[];
             getTransitionEndNameList(): string[];
-            isHide($el: Element): boolean;
             offset(element: HTMLElement, calcScroll?: boolean): DOMRect;
             width(element: HTMLElement | string | Window | Document | typeof globalThis, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
             height(element: HTMLElement | string | Window | Document | typeof globalThis, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
@@ -186,10 +185,10 @@ declare class Pops {
             on<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], callback: (this: HTMLElement, event: T) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): import("./types/PopsDOMUtilsEventType").PopsDOMUtilsAddEventListenerResult;
             on<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T], selectorTarget: HTMLElement) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): import("./types/PopsDOMUtilsEventType").PopsDOMUtilsAddEventListenerResult;
             on<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): import("./types/PopsDOMUtilsEventType").PopsDOMUtilsAddEventListenerResult;
-            off<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], callback?: ((this: HTMLElement, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T]) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
-            off<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], callback?: ((this: HTMLElement, event: T) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
-            off<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], selector?: string | string[] | undefined | null, callback?: ((this: HTMLElement, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T], selectorTarget: HTMLElement) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
-            off<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], selector?: string | string[] | undefined | null, callback?: ((this: HTMLElement, event: T, selectorTarget: HTMLElement) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+            off<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], callback?: (<E extends HTMLElement = HTMLElement>(this: E, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T]) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+            off<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], callback?: (<E extends HTMLElement = HTMLElement>(this: E, event: T) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+            off<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], selector?: string | string[] | undefined | null, callback?: (<E extends HTMLElement = HTMLElement>(this: E, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T], $selector: E) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+            off<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], selector?: string | string[] | undefined | null, callback?: (<E extends HTMLElement = HTMLElement>(this: E, event: T, $selector: E) => void) | undefined, option?: EventListenerOptions | boolean, filter?: (value: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
             offAll(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType?: string): void;
             offAll(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType?: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType | import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType[]): void;
             onReady<T extends (...args: any[]) => any>(callback: T): void;
@@ -203,13 +202,13 @@ declare class Pops {
             onKeydown(target: HTMLElement | Window | typeof globalThis | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keydown"]) => void, option?: boolean | AddEventListenerOptions): import("./types/PopsDOMUtilsEventType").PopsDOMUtilsAddEventListenerResult | undefined;
             preventEvent(event: Event): false;
             preventEvent<T extends boolean>(event: Event, onlyStopPropagation: T): T extends true ? void : false;
-            preventEvent($el: HTMLElement, eventNameList: string | string[], option?: {
+            preventEvent($el: Element | Document | ShadowRoot, eventNameList: string | string[], option?: {
                 capture?: boolean;
                 onlyStopPropagation?: boolean;
             }): {
                 off(): void;
             };
-            preventEvent($el: HTMLElement, eventNameList: string | string[], selector: string | string[] | null | undefined, option?: {
+            preventEvent($el: Element | Document | ShadowRoot, eventNameList: string | string[], selector: string | string[] | null | undefined, option?: {
                 capture?: boolean;
                 onlyStopPropagation?: boolean;
             }): {
@@ -230,7 +229,10 @@ declare class Pops {
                 animElement: HTMLElement | null;
                 isOverMaxZIndex: boolean;
             };
-            sortElementListByProperty<T, R>(getBeforeValueFun: (value: T) => R, getAfterValueFun: (value: T) => R, sortByDesc?: boolean): (after_obj: T, before_obj: T /** 配置 */) => 1 | 0 | -1;
+            sortElementListByProperty<T, R>(getBeforeValueFun: (value: T) => R, getAfterValueFun: (value: T) => R, sortByDesc?: boolean): (after_obj: T, before_obj: T) => 1 | 0 | -1;
+            isHide($el: Element): boolean;
+            isNodeInPopsNode($el: Element): boolean;
+            isAnimNode($el: Element): boolean;
         };
         /** pops处理float类型使用的工具类 */
         MathFloatUtils: {
@@ -240,7 +242,7 @@ declare class Pops {
             division(number1: number, number2: number): number;
         };
         /** 实例处理函数 */
-        PopsInstHandler: {
+        InstHandler: {
             removeInstance(totalInstConfigList: import("./types/inst").PopsInstGeneralConfig[][], guid?: string, isAll?: boolean): Promise<import("./types/inst").PopsInstGeneralConfig[][]>;
             show(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: import("./types/main").PopsInstStoreType, instConfigList: import("./types/inst").PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
             hide(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: import("./types/main").PopsInstStoreType, instConfigList: import("./types/inst").PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
@@ -710,7 +712,7 @@ declare class Pops {
             onAsideItemClick($asideItem: HTMLElement, asideConfig: import("./components/panel/types").PopsPanelContentConfig): void;
         };
         /** pops.panel中的动画 */
-        PopsAnimation: {
+        Animation: {
             $data: {
                 [key: string]: CSSKeyframesRule;
             };
@@ -732,7 +734,7 @@ declare class Pops {
         /** 事件类 */
         EventEmiter: typeof EventEmiter;
         /** 通用的CSS类名 */
-        PopsCommonCSSClassName: {
+        CommonCSSClassName: {
             flexCenter: string;
             flexYCenter: string;
             flexXCenter: string;
@@ -747,7 +749,6 @@ declare class Pops {
             textIsDisabledImportant: string;
         };
     };
-    init(): void;
     /**
      * 释放原有的pops控制权
      * @example

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

@@ -209,9 +209,9 @@ export type PopsDOMUtils_EventType = keyof PopsDOMUtils_Event;
  */
 export declare interface PopsDOMUtilsEventListenerOptionsAttribute {
   /**
-   * DOMUtils的ownCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
+   * DOMUtils的handlerCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
    */
-  callback: (event: Event) => void;
+  handlerCallBack: (event: Event, $selector?: HTMLElement) => void;
   /**
    * 属性配置
    */
@@ -219,7 +219,7 @@ export declare interface PopsDOMUtilsEventListenerOptionsAttribute {
   /**
    * 用户添加的事件
    */
-  originCallBack: (event: Event, selectorTarget?: HTMLElement) => void;
+  callback: (event: Event, $selector?: HTMLElement) => void;
   /**
    * 子元素选择器
    */

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

@@ -16,28 +16,28 @@ export interface PopsMaskConfig {
    */
   enable?: boolean;
   /**
-   * 点击事件
+   * 点击事件配置
    */
   clickEvent?: {
     /**
-     * 点击遮罩层是否触发关闭事件
+     * （可选）点击遮罩层是否触发关闭事件，默认false
      * @default false
      */
     toClose?: boolean;
     /**
-     * 点击遮罩层是否触发隐藏事件
+     * （可选）点击遮罩层是否触发隐藏事件，默认false
      * @default false
      */
     toHide?: boolean;
   };
   /**
    * 遮罩层自定义的点击事件
-   * @param originalRun 当toClose为true，它是关闭弹窗，当toHide为true，它是隐藏弹窗
-   * @param config 配置信息
    */
   clickCallBack?:
     | ((
-        originalRun: () => void | Promise<void>,
+        /** 当toClose为true，它是关闭弹窗，当toHide为true，它是隐藏弹窗 */
+        continueExec: () => void | Promise<void>,
+        /** 配置信息 */
         config:
           | PopsAlertConfig
           | PopsDrawerConfig

package/dist/types/src/utils/PopsDOMUtils.d.ts

@@ -101,7 +101,7 @@ declare class PopsDOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click")
      * DOMUtils.off("a.xx","click")
      */
-    off<T extends PopsDOMUtils_EventType>(element: PopsDOMUtilsElementEventType, eventType: T | T[], callback?: (this: HTMLElement, event: PopsDOMUtils_Event[T]) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends PopsDOMUtils_EventType>(element: PopsDOMUtilsElementEventType, eventType: T | T[], callback?: <E extends HTMLElement = HTMLElement>(this: E, event: PopsDOMUtils_Event[T]) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -115,7 +115,7 @@ declare class PopsDOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click")
      * DOMUtils.off("a.xx","click")
      */
-    off<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], callback?: (this: HTMLElement, event: T) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], callback?: <E extends HTMLElement = HTMLElement>(this: E, event: T) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -130,7 +130,7 @@ declare class PopsDOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click tap hover")
      * DOMUtils.off("a.xx",["click","tap","hover"])
      */
-    off<T extends PopsDOMUtils_EventType>(element: PopsDOMUtilsElementEventType, eventType: T | T[], selector?: string | string[] | undefined | null, callback?: (this: HTMLElement, event: PopsDOMUtils_Event[T], selectorTarget: HTMLElement) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends PopsDOMUtils_EventType>(element: PopsDOMUtilsElementEventType, eventType: T | T[], selector?: string | string[] | undefined | null, callback?: <E extends HTMLElement = HTMLElement>(this: E, event: PopsDOMUtils_Event[T], $selector: E) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -145,7 +145,7 @@ declare class PopsDOMUtilsEvent {
      * DOMUtils.off(document.querySelector("a.xx"),"click tap hover")
      * DOMUtils.off("a.xx",["click","tap","hover"])
      */
-    off<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], selector?: string | string[] | undefined | null, callback?: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
+    off<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], selector?: string | string[] | undefined | null, callback?: <E extends HTMLElement = HTMLElement>(this: E, event: T, $selector: E) => void, option?: EventListenerOptions | boolean, filter?: (value: PopsDOMUtilsEventListenerOptionsAttribute, index: number, array: PopsDOMUtilsEventListenerOptionsAttribute[]) => boolean): void;
     /**
      * 取消绑定所有的事件
      * @param element 需要取消绑定的元素|元素数组
@@ -325,7 +325,7 @@ declare class PopsDOMUtilsEvent {
      *   onlyStopPropagation: true,
      * })
      */
-    preventEvent($el: HTMLElement, eventNameList: string | string[], option?: {
+    preventEvent($el: Element | Document | ShadowRoot, eventNameList: string | string[], option?: {
         /** （可选）是否捕获，默认false */
         capture?: boolean;
         /** （可选）是否仅阻止事件的传播，默认false，不调用`.preventDefault()` */
@@ -352,7 +352,7 @@ declare class PopsDOMUtilsEvent {
      *   onlyStopPropagation: true,
      * })
      */
-    preventEvent($el: HTMLElement, eventNameList: string | string[], selector: string | string[] | null | undefined, option?: {
+    preventEvent($el: Element | Document | ShadowRoot, eventNameList: string | string[], selector: string | string[] | null | undefined, option?: {
         /** （可选）是否捕获，默认false */
         capture?: boolean;
         /** （可选）是否仅阻止事件的传播，默认false，不调用`.preventDefault()` */
@@ -453,18 +453,6 @@ declare class PopsDOMUtils extends PopsDOMUtilsEvent {
     getAnimationEndNameList(): string[];
     /** 获取 transitionend 在各个浏览器的兼容名 */
     getTransitionEndNameList(): string[];
-    /**
-     * 是否是隐藏状态
-     *
-     * 检测以下项：
-     *
-     * + `display`: none
-     * + `visibility`: hidden
-     * + `opacity`: 0
-     * + `使用了pops的自定义的隐藏class类`
-     * @param $el 需要检测的元素
-     */
-    isHide($el: Element): boolean;
     /**
      * 实现jQuery中的$().offset();
      * @param element

package/dist/types/src/utils/PopsInstanceUtils.d.ts

@@ -15,4 +15,26 @@ export declare const PopsInstanceUtils: {
      * @param sortByDesc 排序是否降序，默认降序
      */
     sortElementListByProperty<T, R>(getBeforeValueFun: (value: T) => R, getAfterValueFun: (value: T) => R, sortByDesc?: boolean): (after_obj: T, before_obj: T) => 1 | 0 | -1;
+    /**
+     * 是否是隐藏状态
+     *
+     * 检测以下项：
+     *
+     * + `display`: none
+     * + `visibility`: hidden
+     * + `opacity`: 0
+     * + `使用了pops的自定义的隐藏class类`
+     * @param $el 需要检测的元素
+     */
+    isHide($el: Element): boolean;
+    /**
+     * 判断元素是否是在`.pops`内
+     * @param $el 目标元素
+     */
+    isNodeInPopsNode($el: Element): boolean;
+    /**
+     * 判断是否是`.pops-anim`元素
+     * @param $el 目标元素
+     */
+    isAnimNode($el: Element): boolean;
 };

package/dist/types/src/utils/PopsUtils.d.ts

@@ -1,5 +1,5 @@
-import AnyTouch from "any-touch";
 import doubletap from "@any-touch/doubletap";
+import AnyTouch from "any-touch";
 declare class PopsUtils {
     /**
      * 超时时间

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/pops",
-  "version": "4.1.0",
+  "version": "4.2.1",
   "description": "弹窗库，包含了alert、confirm、prompt、drawer、folder、loading、iframe、panel、tooltip、searchSuggestion、rightClickMenu组件",
   "keywords": [
     "ScriptCat",

package/src/Pops.ts

@@ -41,6 +41,7 @@ class Pops {
   config = {
     /** 版本号 */
     version: version,
+    /** 样式配置 */
     cssText: PopsCSS,
     /** icon图标的svg代码 */
     iconSVG: PopsIcon.$data,
@@ -48,12 +49,9 @@ class Pops {
     animation: PopsAnimation.$data,
     /** 存储已创建的元素 */
     instData: PopsInstData,
-    /** 禁止滚动 */
-    forbiddenScroll: {
-      event(event: Event) {
-        return popsDOMUtils.preventEvent(event);
-      },
-    },
+  };
+  /** 导出的函数 */
+  fn = {
     /** pops使用的工具类 */
     Utils: popsUtils,
     /** pops使用的DOM工具类 */
@@ -63,17 +61,16 @@ class Pops {
     /** pops处理float类型使用的工具类 */
     MathFloatUtils: PopsMathFloatUtils,
     /** 实例处理函数 */
-    PopsInstHandler,
+    InstHandler: PopsInstHandler,
     /** pops.panel中用于处理各个类型的工具 */
-    PanelHandlerComponents,
+    PanelHandlerComponents: PanelHandlerComponents,
     /** pops.panel中的动画 */
-    PopsAnimation,
+    Animation: PopsAnimation,
     /** 事件类 */
-    EventEmiter,
+    EventEmiter: EventEmiter,
     /** 通用的CSS类名 */
-    PopsCommonCSSClassName,
+    CommonCSSClassName: PopsCommonCSSClassName,
   };
-  init() {}
   /**
    * 释放原有的pops控制权
    * @example

package/src/components/panel/handlerComponents.ts

@@ -1963,12 +1963,12 @@ export const PanelHandlerComponents = () => {
                   },
                   mask: {
                     enable: true,
-                    clickCallBack(originalRun) {
+                    clickCallBack(continueExec) {
                       const ret = dialogCloseCallback();
                       if (typeof ret === "boolean" && !ret) {
                         return;
                       }
-                      originalRun();
+                      continueExec();
                     },
                     clickEvent: {
                       toClose: true,
@@ -3171,8 +3171,8 @@ export const PanelHandlerComponents = () => {
                 },
                 mask: {
                   enable: true,
-                  clickCallBack(originalRun) {
-                    originalRun();
+                  clickCallBack(continueExec) {
+                    continueExec();
                     dialogCloseCallback();
                   },
                   clickEvent: {

package/src/handler/PopsHandler.ts

@@ -16,6 +16,7 @@ import type { CustomEventMap } from "../types/EventEmitter";
 import type { PopsInstGeneralConfig } from "../types/inst";
 import type { PopsInstStoreType, PopsSupportAnimConfigType, PopsSupportOnlyConfig, PopsType } from "../types/main";
 import { popsDOMUtils } from "../utils/PopsDOMUtils";
+import { PopsInstanceUtils } from "../utils/PopsInstanceUtils";
 import { popsUtils } from "../utils/PopsUtils";
 import { PopsInstHandler } from "./PopsInstHandler";
 
@@ -154,11 +155,11 @@ export const PopsHandler = {
      * 点击其它区域的事件
      * @param event
      */
-    function clickEvent(event: MouseEvent | PointerEvent) {
+    const clickEvent = (event: MouseEvent | PointerEvent) => {
       popsDOMUtils.preventEvent(event);
       // 获取该类型实例存储列表
       const targetInst = PopsInstData[config.type];
-      function originalRun() {
+      const continueExec = () => {
         if (config.config.mask!.clickEvent!.toClose) {
           // 关闭
           return PopsInstHandler.close(config.config, config.type, targetInst, config.guid, config.animElement);
@@ -173,38 +174,25 @@ export const PopsHandler = {
             result.maskElement
           );
         }
-      }
+      };
       if (typeof config.config.mask.clickCallBack === "function") {
-        config.config.mask.clickCallBack(originalRun, config.config);
+        config.config.mask.clickCallBack(continueExec, config.config);
       } else {
-        originalRun();
+        continueExec();
       }
       return false;
-    }
+    };
     // 判断是否启用了遮罩层点击动作
     if (config.config.mask.clickEvent!.toClose || config.config.mask.clickEvent!.toHide) {
-      /**
-       * 判断点击的元素是否是动画层的元素
-       * @param element
-       * @returns
-       */
-      function isAnimElement(element: HTMLElement) {
-        return Boolean(
-          element?.localName?.toLowerCase() === "div" &&
-          element.className &&
-          element.className === "pops-anim" &&
-          element.hasAttribute("anim")
-        );
-      }
       // 判断按下的元素是否是pops-anim
       popsDOMUtils.on(config.animElement, "pointerup", (event) => {
         const $click = event.composedPath()[0] as HTMLElement;
-        isMaskClick = isAnimElement($click);
+        isMaskClick = PopsInstanceUtils.isAnimNode($click);
       });
       // 如果有动画层，在动画层上监听点击事件
       popsDOMUtils.on<MouseEvent | PointerEvent>(config.animElement, "click", (event) => {
         const $click = event.composedPath()[0] as HTMLElement;
-        if (isMaskClick && isAnimElement($click)) {
+        if (isMaskClick && PopsInstanceUtils.isAnimNode($click)) {
           return clickEvent(event);
         }
       });

package/src/handler/PopsInstHandler.ts

@@ -14,6 +14,7 @@ import { PopsInstData } from "../PopsInst";
 import type { PopsInstGeneralConfig } from "../types/inst";
 import type { PopsInstStoreType } from "../types/main";
 import { popsDOMUtils } from "../utils/PopsDOMUtils";
+import { PopsInstanceUtils } from "../utils/PopsInstanceUtils";
 import { popsUtils } from "../utils/PopsUtils";
 
 export const PopsInstHandler = {
@@ -117,7 +118,7 @@ export const PopsInstHandler = {
         // 先设置好动画状态
         // 再显示，会自执行动画
         const checkVisible = () => {
-          if (!popsDOMUtils.isHide($anim)) {
+          if (!PopsInstanceUtils.isHide($anim)) {
             return true;
           } else {
             return false;
@@ -221,7 +222,7 @@ export const PopsInstHandler = {
         // 再隐藏
         // 存在实例
         const checkVisible = () => {
-          if (!popsDOMUtils.isHide($anim)) {
+          if (!PopsInstanceUtils.isHide($anim)) {
             return true;
           } else {
             return false;

package/src/types/PopsDOMUtilsEventType.d.ts

@@ -209,9 +209,9 @@ export type PopsDOMUtils_EventType = keyof PopsDOMUtils_Event;
  */
 export declare interface PopsDOMUtilsEventListenerOptionsAttribute {
   /**
-   * DOMUtils的ownCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
+   * DOMUtils的handlerCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
    */
-  callback: (event: Event) => void;
+  handlerCallBack: (event: Event, $selector?: HTMLElement) => void;
   /**
    * 属性配置
    */
@@ -219,7 +219,7 @@ export declare interface PopsDOMUtilsEventListenerOptionsAttribute {
   /**
    * 用户添加的事件
    */
-  originCallBack: (event: Event, selectorTarget?: HTMLElement) => void;
+  callback: (event: Event, $selector?: HTMLElement) => void;
   /**
    * 子元素选择器
    */

package/src/types/mask.d.ts

@@ -16,28 +16,28 @@ export interface PopsMaskConfig {
    */
   enable?: boolean;
   /**
-   * 点击事件
+   * 点击事件配置
    */
   clickEvent?: {
     /**
-     * 点击遮罩层是否触发关闭事件
+     * （可选）点击遮罩层是否触发关闭事件，默认false
      * @default false
      */
     toClose?: boolean;
     /**
-     * 点击遮罩层是否触发隐藏事件
+     * （可选）点击遮罩层是否触发隐藏事件，默认false
      * @default false
      */
     toHide?: boolean;
   };
   /**
    * 遮罩层自定义的点击事件
-   * @param originalRun 当toClose为true，它是关闭弹窗，当toHide为true，它是隐藏弹窗
-   * @param config 配置信息
    */
   clickCallBack?:
     | ((
-        originalRun: () => void | Promise<void>,
+        /** 当toClose为true，它是关闭弹窗，当toHide为true，它是隐藏弹窗 */
+        continueExec: () => void | Promise<void>,
+        /** 配置信息 */
         config:
           | PopsAlertConfig
           | PopsDrawerConfig