@whitesev/pops 3.0.2 → 3.1.0

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

@@ -158,26 +158,26 @@ declare class Pops {
             onInput($el: HTMLInputElement | HTMLTextAreaElement, callback: (evt: InputEvent) => void | Promise<void>, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): {
                 off: () => void;
             };
-            on<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, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): void;
-            on<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], callback: (this: HTMLElement, event: T) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): void;
-            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): void;
-            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): void;
+            on<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, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): import("./types/PopsDOMUtilsEventType").PopsDOMUtilsAddEventListenerResult;
+            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;
             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;
-            ready<T extends (...args: any[]) => any>(callback: T): void;
-            trigger(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: string | string[], details?: object, useDispatchToTriggerEvent?: boolean): void;
-            trigger(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType | import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType[], details?: object, useDispatchToTriggerEvent?: boolean): void;
-            click(element: HTMLElement | string | Window, handler?: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["click"]) => void, details?: any, useDispatchToTriggerEvent?: boolean): void;
-            blur(element: HTMLElement | string | Window, handler?: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["blur"]) => void, details?: object, useDispatchToTriggerEvent?: boolean): void;
-            focus(element: HTMLElement | string | Window, handler?: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["focus"]) => void, details?: object, useDispatchToTriggerEvent?: boolean): void;
-            hover(element: HTMLElement | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["hover"]) => void, option?: boolean | AddEventListenerOptions): void;
-            keyup(target: HTMLElement | string | Window | typeof globalThis, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keyup"]) => void, option?: boolean | AddEventListenerOptions): void;
-            keydown(target: HTMLElement | Window | typeof globalThis | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keydown"]) => void, option?: boolean | AddEventListenerOptions): void;
-            keypress(target: HTMLElement | Window | typeof globalThis | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keypress"]) => void, option?: boolean | AddEventListenerOptions): void;
+            onReady<T extends (...args: any[]) => any>(callback: T): void;
+            emit(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: string | string[], details?: object, useDispatchToEmitEvent?: boolean): void;
+            emit(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType | import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType[], details?: object, useDispatchToEmitEvent?: boolean): void;
+            click(element: HTMLElement | string | Window, handler?: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["click"]) => void, details?: any, useDispatchToEmitEvent?: boolean): void;
+            blur(element: HTMLElement | string | Window, handler?: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["blur"]) => void, details?: object, useDispatchToEmitEvent?: boolean): void;
+            focus(element: HTMLElement | string | Window, handler?: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["focus"]) => void, details?: object, useDispatchToEmitEvent?: boolean): void;
+            onHover(element: HTMLElement | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["hover"]) => void, option?: boolean | AddEventListenerOptions): void;
+            onKeyup(target: HTMLElement | string | Window | typeof globalThis, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keyup"]) => void, option?: boolean | AddEventListenerOptions): void;
+            onKeydown(target: HTMLElement | Window | typeof globalThis | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keydown"]) => void, option?: boolean | AddEventListenerOptions): void;
+            onKeypress(target: HTMLElement | Window | typeof globalThis | string, handler: (event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event["keypress"]) => void, option?: boolean | AddEventListenerOptions): void;
             preventEvent(event: Event): boolean;
             preventEvent(element: HTMLElement, eventNameList?: string | string[], capture?: boolean): boolean;
             selector<K extends keyof HTMLElementTagNameMap>(selector: K): HTMLElementTagNameMap[K] | undefined;
@@ -207,7 +207,7 @@ declare class Pops {
             drag($move: HTMLElement, options: {
                 dragElement: HTMLElement;
                 limit: boolean;
-                triggerClick?: boolean;
+                emitClick?: boolean;
                 extraDistance: number;
                 container?: Window | typeof globalThis | HTMLElement;
                 moveCallBack?: (moveElement: HTMLElement, left: number, top: number) => void;
@@ -393,7 +393,7 @@ declare class Pops {
                     showCircleIconWrapper(): void;
                     onIconClick(): void;
                     onValueChange(): void;
-                    triggerValueChange(): void;
+                    emitValueChange(): void;
                     addValidErrorMsg(msg?: string): void;
                     removeValidErrorMsg(): void;
                 };
@@ -609,7 +609,7 @@ declare class Pops {
                     }): void;
                     checkTagEmpty(): void;
                     removeSelectedTagItem($tag: HTMLElement): void;
-                    removeSelectedInfo(data: import("./components/panel/types/components-selectMultiple").PopsPanelSelectMultipleDataOption<any>, triggerValueChangeCallBack?: boolean): void;
+                    removeSelectedInfo(data: import("./components/panel/types/components-selectMultiple").PopsPanelSelectMultipleDataOption<any>, emitValueChangeCallBack?: boolean): void;
                     showInputWrapper(): void;
                     hideInputWrapper(): void;
                     showPlaceHolderWrapper(): void;
@@ -668,7 +668,7 @@ declare class Pops {
                 $el: HTMLLIElement;
             } | undefined;
             createSectionContainerItem_forms(viewConfig: import("./components/panel/types").PopsPanelContentConfig | import("./components/panel/types/components-container").PopsPanelContainerConfig): void;
-            triggerRenderRightContainer($container: HTMLElement): void;
+            emitRenderRightContainer($container: HTMLElement): void;
             uListContainerAddItem(viewConfig: import("./components/panel/types").PopsPanelViewConfig, containerOptions: Omit<import("./components/panel/types/components-common").PopsPanelRightAsideContainerConfig, "target">): void;
             onAsideItemClick($asideItem: HTMLElement, asideConfig: import("./components/panel/types").PopsPanelContentConfig): void;
         };
@@ -757,8 +757,8 @@ declare class Pops {
             isFixed: boolean;
             alwaysShow: boolean;
             delayCloseTime: number;
-            triggerShowEventName: string;
-            triggerCloseEventName: string;
+            onShowEventName: string;
+            onCloseEventName: string;
             eventOption: {
                 once: boolean;
                 passive: boolean;

package/dist/types/src/components/panel/handlerComponents.d.ts

@@ -471,7 +471,7 @@ export declare const PanelHandlerComponents: () => {
             /**
              * 主动触发输入框改变事件
              */
-            triggerValueChange(): void;
+            emitValueChange(): void;
             /**
              * 添加校验失败的提示信息
              * @param msg 提示信息
@@ -717,7 +717,6 @@ export declare const PanelHandlerComponents: () => {
             /**
              * 添加选中信息
              * @param data 选择项的数据
-             * @param [triggerValueChangeCallBack=true] 主动触发值改变回调
              */
             addSelectedItemInfo(data: PopsPanelSelectDataOption<any>): void;
             /**
@@ -869,7 +868,6 @@ export declare const PanelHandlerComponents: () => {
             /**
              * 添加选中信息
              * @param data 选择项的数据
-             * @param [triggerValueChangeCallBack=true] 主动触发值改变回调
              */
             addSelectedItemInfo(data: PopsPanelSelectDataOption<any>): void;
             /**
@@ -1129,11 +1127,11 @@ export declare const PanelHandlerComponents: () => {
             /**
              * 从保存的已选中的信息列表中移除目标信息
              * @param data 需要移除的信息
-             * @param [triggerValueChangeCallBack=true] 是否触发值改变的回调
+             * @param [emitValueChangeCallBack=true] 是否触发值改变的回调
              * + true （默认）触发值改变的回调
              * + false 不触发值改变的回调
              */
-            removeSelectedInfo(data: PopsPanelSelectMultipleDataOption<any>, triggerValueChangeCallBack?: boolean): void;
+            removeSelectedInfo(data: PopsPanelSelectMultipleDataOption<any>, emitValueChangeCallBack?: boolean): void;
             /** 显示输入框 */
             showInputWrapper(): void;
             /** 隐藏输入框 */
@@ -1279,7 +1277,7 @@ export declare const PanelHandlerComponents: () => {
      * 主动触发触发渲染右侧容器的事件
      * @param $container 容器
      */
-    triggerRenderRightContainer($container: HTMLElement): void;
+    emitRenderRightContainer($container: HTMLElement): void;
     /**
      *
      * @param viewConfig

package/dist/types/src/components/tooltip/index.d.ts

@@ -190,8 +190,8 @@ export declare const PopsTooltip: {
             isFixed: boolean;
             alwaysShow: boolean;
             delayCloseTime: number;
-            triggerShowEventName: string;
-            triggerCloseEventName: string;
+            onShowEventName: string;
+            onCloseEventName: string;
             eventOption: {
                 once: boolean;
                 passive: boolean;

package/dist/types/src/components/tooltip/types/index.d.ts

@@ -42,7 +42,7 @@ export interface PopsToolTipConfig extends Pick<PopsGeneralConfig, "useShadowRoo
     isFixed?: boolean;
     /**
      * 是否总是显示，默认为false
-     * + true 设置的triggerShowEventName、triggerCloseEventName将无效
+     * + true 设置的onShowEventName、onCloseEventName将无效
      *        返回提供show和close函数，取消on和off
      * + false 事件触发才显示
      */
@@ -56,12 +56,12 @@ export interface PopsToolTipConfig extends Pick<PopsGeneralConfig, "useShadowRoo
      * 触发显示事件的名称，默认mouseenter touchstart，如果是多个事件，按空格分割
      * @default  "mouseenter touchstart"
      */
-    triggerShowEventName?: string;
+    onShowEventName?: string;
     /**
      * 触发关闭事件的名称，默认mouseleave touchend，如果是多个事件，按空格分割
      * @default  "mouseleave touchend"
      */
-    triggerCloseEventName?: string;
+    onCloseEventName?: string;
     /**
      * 监听的事件配置
      */

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

@@ -237,6 +237,28 @@ export type PopsDOMUtilsElementEventType =
   | ChildNode
   | Node;
 
+/**
+ * 通过.on执行后的返回值
+ */
+export declare interface PopsDOMUtilsAddEventListenerResult {
+  /**
+   * 取消绑定的监听事件
+   * @param filter (可选)过滤函数，对元素属性上的事件进行过滤出想要删除的事件
+   */
+  off(
+    filter?: (
+      value: PopsDOMUtilsEventListenerOptionsAttribute,
+      index: number,
+      array: PopsDOMUtilsEventListenerOptionsAttribute[]
+    ) => boolean
+  ): void;
+  /**
+   * 主动触发事件
+   * @param details 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
+   * @param useDispatchToEmit 是否使用dispatchEvent来触发事件，默认true，如果为false，则直接调用callback，但是这种会让使用了selectorTarget的没有值
+   */
+  emit(details?: object, useDispatchToEmit?: boolean): void;
+}
 export type ParseHTMLReturnType<T1, T2> = T1 extends true ? (T2 extends true ? Document : HTMLElement) : HTMLElement;
 
 /**

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

@@ -1,4 +1,4 @@
-import type { ParseHTMLReturnType, PopsDOMUtils_EventType, PopsDOMUtilsCreateElementAttributesMap, PopsDOMUtilsEventListenerOption, PopsDOMUtilsEventListenerOptionsAttribute, PopsDOMUtils_Event, PopsDOMUtilsElementEventType } from "../types/PopsDOMUtilsEventType";
+import type { ParseHTMLReturnType, PopsDOMUtils_EventType, PopsDOMUtilsCreateElementAttributesMap, PopsDOMUtilsEventListenerOption, PopsDOMUtilsEventListenerOptionsAttribute, PopsDOMUtils_Event, PopsDOMUtilsElementEventType, PopsDOMUtilsAddEventListenerResult } from "../types/PopsDOMUtilsEventType";
 declare class PopsDOMUtilsEvent {
     /**
      * 绑定事件
@@ -18,7 +18,7 @@ declare class PopsDOMUtilsEvent {
      *    console.log("事件触发",event)
      * })
      */
-    on<T extends PopsDOMUtils_EventType>(element: PopsDOMUtilsElementEventType, eventType: T | T[], callback: (this: HTMLElement, event: PopsDOMUtils_Event[T]) => void, option?: PopsDOMUtilsEventListenerOption | boolean): void;
+    on<T extends PopsDOMUtils_EventType>(element: PopsDOMUtilsElementEventType, eventType: T | T[], callback: (this: HTMLElement, event: PopsDOMUtils_Event[T]) => void, option?: PopsDOMUtilsEventListenerOption | boolean): PopsDOMUtilsAddEventListenerResult;
     /**
      * 绑定事件
      * @param element 需要绑定的元素|元素数组|window
@@ -37,7 +37,7 @@ declare class PopsDOMUtilsEvent {
      *    console.log("事件触发",event)
      * })
      */
-    on<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], callback: (this: HTMLElement, event: T) => void, option?: PopsDOMUtilsEventListenerOption | boolean): void;
+    on<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], callback: (this: HTMLElement, event: T) => void, option?: PopsDOMUtilsEventListenerOption | boolean): PopsDOMUtilsAddEventListenerResult;
     /**
      * 绑定事件
      * @param element 需要绑定的元素|元素数组|window
@@ -62,7 +62,7 @@ declare class PopsDOMUtilsEvent {
      *    console.log("事件触发", event, selectorTarget)
      * })
      */
-    on<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?: PopsDOMUtilsEventListenerOption | boolean): void;
+    on<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?: PopsDOMUtilsEventListenerOption | boolean): PopsDOMUtilsAddEventListenerResult;
     /**
      * 绑定事件
      * @param element 需要绑定的元素|元素数组|window
@@ -87,7 +87,7 @@ declare class PopsDOMUtilsEvent {
      *    console.log("事件触发", event, selectorTarget)
      * })
      */
-    on<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: PopsDOMUtilsEventListenerOption | boolean): void;
+    on<T extends Event>(element: PopsDOMUtilsElementEventType, eventType: string | string[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: T, selectorTarget: HTMLElement) => void, option?: PopsDOMUtilsEventListenerOption | boolean): PopsDOMUtilsAddEventListenerResult;
     /**
      * 取消绑定事件
      * @param element 需要取消绑定的元素|元素数组
@@ -162,47 +162,47 @@ declare class PopsDOMUtilsEvent {
      * 等待文档加载完成后执行指定的函数
      * @param callback 需要执行的函数
      * @example
-     * DOMUtils.ready(function(){
+     * DOMUtils.onReady(function(){
      *   console.log("文档加载完毕")
      * })
      */
-    ready<T extends (...args: any[]) => any>(callback: T): void;
+    onReady<T extends (...args: any[]) => any>(callback: T): void;
     /**
      * 主动触发事件
      * @param element 需要触发的元素|元素数组|window
      * @param eventType 需要触发的事件
      * @param details 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
-     * @param useDispatchToTriggerEvent 是否使用dispatchEvent来触发事件,默认true
+     * @param useDispatchToEmitEvent 是否使用dispatchEvent来触发事件,默认true
      * @example
      * // 触发元素a.xx的click事件
-     * DOMUtils.trigger(document.querySelector("a.xx"),"click")
-     * DOMUtils.trigger("a.xx","click")
+     * DOMUtils.emit(document.querySelector("a.xx"),"click")
+     * DOMUtils.emit("a.xx","click")
      * // 触发元素a.xx的click、tap、hover事件
-     * DOMUtils.trigger(document.querySelector("a.xx"),"click tap hover")
-     * DOMUtils.trigger("a.xx",["click","tap","hover"])
+     * DOMUtils.emit(document.querySelector("a.xx"),"click tap hover")
+     * DOMUtils.emit("a.xx",["click","tap","hover"])
      */
-    trigger(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: string | string[], details?: object, useDispatchToTriggerEvent?: boolean): void;
+    emit(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: string | string[], details?: object, useDispatchToEmitEvent?: boolean): void;
     /**
      * 主动触发事件
      * @param element 需要触发的元素|元素数组|window
      * @param eventType 需要触发的事件
      * @param details 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
-     * @param useDispatchToTriggerEvent 是否使用dispatchEvent来触发事件,默认true
+     * @param useDispatchToEmitEvent 是否使用dispatchEvent来触发事件,默认true
      * @example
      * // 触发元素a.xx的click事件
-     * DOMUtils.trigger(document.querySelector("a.xx"),"click")
-     * DOMUtils.trigger("a.xx","click")
+     * DOMUtils.emit(document.querySelector("a.xx"),"click")
+     * DOMUtils.emit("a.xx","click")
      * // 触发元素a.xx的click、tap、hover事件
-     * DOMUtils.trigger(document.querySelector("a.xx"),"click tap hover")
-     * DOMUtils.trigger("a.xx",["click","tap","hover"])
+     * DOMUtils.emit(document.querySelector("a.xx"),"click tap hover")
+     * DOMUtils.emit("a.xx",["click","tap","hover"])
      */
-    trigger(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: PopsDOMUtils_EventType | PopsDOMUtils_EventType[], details?: object, useDispatchToTriggerEvent?: boolean): void;
+    emit(element: HTMLElement | string | NodeList | any[] | Window | Document, eventType: PopsDOMUtils_EventType | PopsDOMUtils_EventType[], details?: object, useDispatchToEmitEvent?: boolean): void;
     /**
      * 绑定或触发元素的click事件
      * @param element 目标元素
      * @param handler （可选）事件处理函数
      * @param details （可选）赋予触发的Event的额外属性
-     * @param useDispatchToTriggerEvent （可选）是否使用dispatchEvent来触发事件,默认true
+     * @param useDispatchToEmitEvent （可选）是否使用dispatchEvent来触发事件,默认true
      * @example
      * // 触发元素a.xx的click事件
      * DOMUtils.click(document.querySelector("a.xx"))
@@ -211,13 +211,13 @@ declare class PopsDOMUtilsEvent {
      *  console.log("触发click事件成功")
      * })
      * */
-    click(element: HTMLElement | string | Window, handler?: (event: PopsDOMUtils_Event["click"]) => void, details?: any, useDispatchToTriggerEvent?: boolean): void;
+    click(element: HTMLElement | string | Window, handler?: (event: PopsDOMUtils_Event["click"]) => void, details?: any, useDispatchToEmitEvent?: boolean): void;
     /**
      * 绑定或触发元素的blur事件
      * @param element 目标元素
      * @param handler （可选）事件处理函数
      * @param details （可选）赋予触发的Event的额外属性
-     * @param useDispatchToTriggerEvent （可选）是否使用dispatchEvent来触发事件,默认true
+     * @param useDispatchToEmitEvent （可选）是否使用dispatchEvent来触发事件,默认true
      * @example
      * // 触发元素a.xx的blur事件
      * DOMUtils.blur(document.querySelector("a.xx"))
@@ -226,13 +226,13 @@ declare class PopsDOMUtilsEvent {
      *  console.log("触发blur事件成功")
      * })
      * */
-    blur(element: HTMLElement | string | Window, handler?: (event: PopsDOMUtils_Event["blur"]) => void, details?: object, useDispatchToTriggerEvent?: boolean): void;
+    blur(element: HTMLElement | string | Window, handler?: (event: PopsDOMUtils_Event["blur"]) => void, details?: object, useDispatchToEmitEvent?: boolean): void;
     /**
      * 绑定或触发元素的focus事件
      * @param element 目标元素
      * @param handler （可选）事件处理函数
      * @param details （可选）赋予触发的Event的额外属性
-     * @param useDispatchToTriggerEvent （可选）是否使用dispatchEvent来触发事件,默认true
+     * @param useDispatchToEmitEvent （可选）是否使用dispatchEvent来触发事件,默认true
      * @example
      * // 触发元素a.xx的focus事件
      * DOMUtils.focus(document.querySelector("a.xx"))
@@ -241,7 +241,7 @@ declare class PopsDOMUtilsEvent {
      *  console.log("触发focus事件成功")
      * })
      * */
-    focus(element: HTMLElement | string | Window, handler?: (event: PopsDOMUtils_Event["focus"]) => void, details?: object, useDispatchToTriggerEvent?: boolean): void;
+    focus(element: HTMLElement | string | Window, handler?: (event: PopsDOMUtils_Event["focus"]) => void, details?: object, useDispatchToEmitEvent?: boolean): void;
     /**
      * 当鼠标移入或移出元素时触发事件
      * @param element 当前元素
@@ -256,7 +256,7 @@ declare class PopsDOMUtilsEvent {
      *   console.log("移入/移除");
      * })
      */
-    hover(element: HTMLElement | string, handler: (event: PopsDOMUtils_Event["hover"]) => void, option?: boolean | AddEventListenerOptions): void;
+    onHover(element: HTMLElement | string, handler: (event: PopsDOMUtils_Event["hover"]) => void, option?: boolean | AddEventListenerOptions): void;
     /**
      * 当按键松开时触发事件
      * keydown - > keypress - > keyup
@@ -272,7 +272,7 @@ declare class PopsDOMUtilsEvent {
      *   console.log("按键松开");
      * })
      */
-    keyup(target: HTMLElement | string | Window | typeof globalThis, handler: (event: PopsDOMUtils_Event["keyup"]) => void, option?: boolean | AddEventListenerOptions): void;
+    onKeyup(target: HTMLElement | string | Window | typeof globalThis, handler: (event: PopsDOMUtils_Event["keyup"]) => void, option?: boolean | AddEventListenerOptions): void;
     /**
      * 当按键按下时触发事件
      * keydown - > keypress - > keyup
@@ -288,7 +288,7 @@ declare class PopsDOMUtilsEvent {
      *   console.log("按键按下");
      * })
      */
-    keydown(target: HTMLElement | Window | typeof globalThis | string, handler: (event: PopsDOMUtils_Event["keydown"]) => void, option?: boolean | AddEventListenerOptions): void;
+    onKeydown(target: HTMLElement | Window | typeof globalThis | string, handler: (event: PopsDOMUtils_Event["keydown"]) => void, option?: boolean | AddEventListenerOptions): void;
     /**
      * 当按键按下时触发事件
      * keydown - > keypress - > keyup
@@ -304,7 +304,7 @@ declare class PopsDOMUtilsEvent {
      *   console.log("按键按下");
      * })
      */
-    keypress(target: HTMLElement | Window | typeof globalThis | string, handler: (event: PopsDOMUtils_Event["keypress"]) => void, option?: boolean | AddEventListenerOptions): void;
+    onKeypress(target: HTMLElement | Window | typeof globalThis | string, handler: (event: PopsDOMUtils_Event["keypress"]) => void, option?: boolean | AddEventListenerOptions): void;
     /**
      * 阻止事件传递
      * @param element 要进行处理的元素

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

@@ -89,7 +89,7 @@ export declare const PopsInstanceUtils: {
     drag($move: HTMLElement, options: {
         dragElement: HTMLElement;
         limit: boolean;
-        triggerClick?: boolean;
+        emitClick?: boolean;
         extraDistance: number;
         container?: Window | typeof globalThis | HTMLElement;
         moveCallBack?: (moveElement: HTMLElement, left: number, top: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/pops",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "弹窗库，包含了alert、confirm、prompt、drawer、loading、iframe、rightClickMenu等组件",
   "type": "module",
   "homepage": "https://github.com/WhiteSevs/TamperMonkeyScript/tree/master/lib/pops#readme",
@@ -51,7 +51,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "12.3.0",
     "browserslist": "^4.28.0",
-    "caniuse-lite": "^1.0.30001756",
+    "caniuse-lite": "^1.0.30001757",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-compat": "^6.0.2",
@@ -62,7 +62,7 @@
     "rollup-plugin-import-css": "^4.1.2",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.47.0"
+    "typescript-eslint": "^8.48.0"
   },
   "scripts": {
     "lint": "eslint .",

package/src/components/folder/index.ts

@@ -345,15 +345,15 @@ export const PopsFolder = {
         );
         // 设置默认触发的arrow
         if (config.sort.name === "fileName") {
-          popsDOMUtils.trigger(folderListSortFileNameElement, "click", {
+          popsDOMUtils.emit(folderListSortFileNameElement, "click", {
             notChangeSortRule: true,
           });
         } else if (config.sort.name === "latestTime") {
-          popsDOMUtils.trigger(folderListSortLatestTimeElement, "click", {
+          popsDOMUtils.emit(folderListSortLatestTimeElement, "click", {
             notChangeSortRule: true,
           });
         } else if (config.sort.name === "fileSize") {
-          popsDOMUtils.trigger(folderListSortFileSizeElement, "click", {
+          popsDOMUtils.emit(folderListSortFileSizeElement, "click", {
             notChangeSortRule: true,
           });
         }

package/src/components/panel/handlerComponents.ts

@@ -1329,7 +1329,7 @@ export const PanelHandlerComponents = () => {
         /**
          * 主动触发输入框改变事件
          */
-        triggerValueChange() {
+        emitValueChange() {
           this.$el.input.dispatchEvent(new Event("input"));
         },
         /**
@@ -2127,7 +2127,6 @@ export const PanelHandlerComponents = () => {
           /**
            * 添加选中信息
            * @param data 选择项的数据
-           * @param [triggerValueChangeCallBack=true] 主动触发值改变回调
            */
           addSelectedItemInfo(data: PopsPanelSelectDataOption<any>) {
             this.resetCurrentSelectedInfo();
@@ -2532,7 +2531,6 @@ export const PanelHandlerComponents = () => {
           /**
            * 添加选中信息
            * @param data 选择项的数据
-           * @param [triggerValueChangeCallBack=true] 主动触发值改变回调
            */
           addSelectedItemInfo(data: PopsPanelSelectDataOption<any>) {
             this.resetCurrentSelectedInfo();
@@ -3255,11 +3253,11 @@ export const PanelHandlerComponents = () => {
         /**
          * 从保存的已选中的信息列表中移除目标信息
          * @param data 需要移除的信息
-         * @param [triggerValueChangeCallBack=true] 是否触发值改变的回调
+         * @param [emitValueChangeCallBack=true] 是否触发值改变的回调
          * + true （默认）触发值改变的回调
          * + false 不触发值改变的回调
          */
-        removeSelectedInfo(data: PopsPanelSelectMultipleDataOption<any>, triggerValueChangeCallBack: boolean = true) {
+        removeSelectedInfo(data: PopsPanelSelectMultipleDataOption<any>, emitValueChangeCallBack: boolean = true) {
           for (let index = 0; index < this.$data.selectedDataList.length; index++) {
             const selectInfo = this.$data.selectedDataList[index];
             if (selectInfo.value === data.value) {
@@ -3267,7 +3265,7 @@ export const PanelHandlerComponents = () => {
               break;
             }
           }
-          triggerValueChangeCallBack && this.onValueChange();
+          emitValueChangeCallBack && this.onValueChange();
         },
         /** 显示输入框 */
         showInputWrapper() {
@@ -3698,7 +3696,7 @@ export const PanelHandlerComponents = () => {
                 } else {
                   leaveViewTransition();
                 }
-                that.triggerRenderRightContainer($currentSection);
+                that.emitRenderRightContainer($currentSection);
               },
               {
                 once: true,
@@ -3745,7 +3743,7 @@ export const PanelHandlerComponents = () => {
               $sectionBodyContainer: $deepMenuMain,
             });
           }
-          that.triggerRenderRightContainer($deepMenuSection);
+          that.emitRenderRightContainer($deepMenuSection);
         },
         /** 设置项的点击事件 */
         onLiClick() {
@@ -3900,7 +3898,7 @@ export const PanelHandlerComponents = () => {
      * 主动触发触发渲染右侧容器的事件
      * @param $container 容器
      */
-    triggerRenderRightContainer($container: HTMLElement) {
+    emitRenderRightContainer($container: HTMLElement) {
       const dataViewConfig: PopsPanelEventType["pops:renderRightContainer"]["viewConfig"] = Reflect.get(
         $container,
         this.$data.nodeStoreConfigKey
@@ -3988,7 +3986,7 @@ export const PanelHandlerComponents = () => {
             return;
           }
         }
-        this.triggerRenderRightContainer(this.$el.$panelContentSectionContainer);
+        this.emitRenderRightContainer(this.$el.$panelContentSectionContainer);
       });
     },
   };

package/src/components/rightClickMenu/index.ts

@@ -513,15 +513,15 @@ export const PopsRightClickMenu = {
           }
           // 鼠标|触摸 移入事件
           // 在移动端会先触发touchstart再然后mouseenter
-          let isTriggerTouchEvent = false;
+          let isEmitTouchEvent = false;
           /**
            * 鼠标|触摸 移入事件
            */
           function liElementHoverEvent(event: MouseEvent | TouchEvent) {
             if (event.type === "touchstart") {
-              isTriggerTouchEvent = true;
+              isEmitTouchEvent = true;
             }
-            if (isTriggerTouchEvent && event.type === "mouseenter") {
+            if (isEmitTouchEvent && event.type === "mouseenter") {
               return;
             }
             Array.from(menuULElement.children as any as HTMLLIElement[]).forEach((liElement) => {

package/src/components/tooltip/defaultConfig.ts

@@ -10,8 +10,8 @@ export const PopsTooltipDefaultConfig = (): DeepRequired<PopsToolTipConfig> => {
     className: "",
     isFixed: false,
     alwaysShow: false,
-    triggerShowEventName: "mouseenter touchstart",
-    triggerCloseEventName: "mouseleave touchend",
+    onShowEventName: "mouseenter touchstart",
+    onCloseEventName: "mouseleave touchend",
     zIndex: 10000,
     only: false,
     eventOption: {

package/src/components/tooltip/index.ts

@@ -349,7 +349,7 @@ export class ToolTip {
   onShowEvent() {
     popsDOMUtils.on(
       this.$data.config.$target,
-      this.$data.config.triggerShowEventName,
+      this.$data.config.onShowEventName,
       this.show,
       this.$data.config.eventOption
     );
@@ -358,7 +358,7 @@ export class ToolTip {
    * 取消绑定 显示事件
    */
   offShowEvent() {
-    popsDOMUtils.off(this.$data.config.$target, this.$data.config.triggerShowEventName, this.show, {
+    popsDOMUtils.off(this.$data.config.$target, this.$data.config.onShowEventName, this.show, {
       capture: true,
     });
   }
@@ -419,7 +419,7 @@ export class ToolTip {
   onCloseEvent() {
     popsDOMUtils.on(
       this.$data.config.$target,
-      this.$data.config.triggerCloseEventName,
+      this.$data.config.onCloseEventName,
       this.close,
       this.$data.config.eventOption
     );
@@ -428,7 +428,7 @@ export class ToolTip {
    * 取消绑定 关闭事件
    */
   offCloseEvent() {
-    popsDOMUtils.off(this.$data.config.$target, this.$data.config.triggerCloseEventName, this.close, {
+    popsDOMUtils.off(this.$data.config.$target, this.$data.config.onCloseEventName, this.close, {
       capture: true,
     });
   }

package/src/components/tooltip/types/index.ts

@@ -45,7 +45,7 @@ export interface PopsToolTipConfig
   isFixed?: boolean;
   /**
    * 是否总是显示，默认为false
-   * + true 设置的triggerShowEventName、triggerCloseEventName将无效
+   * + true 设置的onShowEventName、onCloseEventName将无效
    *        返回提供show和close函数，取消on和off
    * + false 事件触发才显示
    */
@@ -59,12 +59,12 @@ export interface PopsToolTipConfig
    * 触发显示事件的名称，默认mouseenter touchstart，如果是多个事件，按空格分割
    * @default  "mouseenter touchstart"
    */
-  triggerShowEventName?: string;
+  onShowEventName?: string;
   /**
    * 触发关闭事件的名称，默认mouseleave touchend，如果是多个事件，按空格分割
    * @default  "mouseleave touchend"
    */
-  triggerCloseEventName?: string;
+  onCloseEventName?: string;
   /**
    * 监听的事件配置
    */