minutool 1.0.20 → 1.0.21

package/dist/index.d.ts

@@ -129,6 +129,54 @@ export declare const base64UrlSafeEncode: (text: string) => string;
  */
 export declare const between: (val: number, min: number, max: number, includeEqual?: boolean) => boolean;
 
+/**
+ * 绑定点击事件，并返回一个解绑函数
+ * @param element - 要绑定事件的元素
+ * @param callback - 事件回调函数
+ * @returns 解绑函数
+ */
+export declare const bindClick: (element: HTMLElement | string, callback: (event: Event) => void) => () => void;
+
+/**
+ * 绑定DOM事件，并返回一个解绑函数
+ * @param element - 要绑定事件的元素
+ * @param eventName - 事件名称
+ * @param callback - 事件回调函数
+ * @returns 解绑函数
+ */
+export declare const bindDomEvent: (element: HTMLElement | string, eventName: string, callback: (event: Event) => void) => () => void;
+
+/**
+ * 绑定双击事件，并返回一个解绑函数
+ * @param element - 要绑定事件的元素
+ * @param callback - 事件回调函数
+ * @returns 解绑函数
+ */
+export declare const bindDoubleClick: (element: HTMLElement | string, callback: (event: Event) => void) => () => void;
+
+/**
+ * 绑定键盘按键按下事件，并返回一个解绑函数
+ * @param element - 要绑定事件的元素
+ * @param callback - 事件回调函数
+ * @returns 解绑函数
+ */
+export declare const bindKeyDown: (element: HTMLElement | string, callback: (event: Event) => void) => () => void;
+
+/**
+ * 绑定键盘按键抬起事件，并返回一个解绑函数
+ * @param element - 要绑定事件的元素
+ * @param callback - 事件回调函数
+ * @returns 解绑函数
+ */
+export declare const bindKeyUp: (element: HTMLElement | string, callback: (event: Event) => void) => () => void;
+
+/**
+ * 绑定对象移动事件
+ * @param element - 要移动的元素
+ * @param handle - 拖动句柄，默认为元素本身
+ */
+export declare function bindNodeMove(element: HTMLElement | string, handle?: HTMLElement | string | null): () => void;
+
 /**
  * 转换 Blob 数据到 Base64 Data URL
  * @param {Blob} blob - Blob 对象
@@ -430,7 +478,7 @@ export declare const escapeHtml: (str: string, tabSize?: number, allowLineBreake
  * @param handler 事件处理函数, 参数为事件对象和匹配的子元素 (event, target)
  * @return 返回一个取消事件委托的函数
  */
-export declare const eventDelegate: (parent: HTMLElement, selector: string, event: string, handler: (event: Event, target: HTMLElement) => void) => () => void;
+export declare const eventDelegate: (parent: HTMLElement | string, selector: string, event: string, handler: (event: Event, target: HTMLElement) => void) => () => void;
 
 /**
  * 退出全屏模式
@@ -846,8 +894,8 @@ export declare const loadScript: (src: string, forceReload?: boolean) => Promise
 
 /**
  * 绑定元素，禁止交互
- * @param {Node} el
- * @param {Function} payload 处理函数，参数为 reset
+ * @param el - DOM 元素或选择器
+ * @param payload - 处理函数，参数为 reset
  */
 export declare const lockElementInteraction: (el: HTMLElement | string, payload: (reset: () => void) => void) => void;
 
@@ -1378,7 +1426,14 @@ export declare const onEvent: (event: string | symbol, handler: EventListenerOrE
 
 export declare const onEvents: (events: (string | symbol)[], handler: EventListenerOrEventListenerObject) => () => void;
 
-export declare const onHover: (el: HTMLElement | string, onHoverIn: () => void, onHoverOut: () => void) => void;
+/**
+ * 绑定元素 hover 事件，返回解绑函数
+ * @param el - DOM 元素或选择器
+ * @param onHoverIn - 鼠标进入回调函数
+ * @param onHoverOut - 鼠标离开回调函数
+ * @returns 返回解绑函数
+ */
+export declare const onHover: (el: HTMLElement | string, onHoverIn: () => void, onHoverOut: () => void) => () => void;
 
 /**
  * 非自关闭标签