@whitesev/domutils 1.3.7 → 1.4.0

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

@@ -1,13 +1,14 @@
-import { type DOMUtilsCreateElementAttributesMap, DOMUtilsEvent } from "./DOMUtilsEvent";
+import { DOMUtilsEvent } from "./DOMUtilsEvent";
+import type { DOMUtilsCreateElementAttributesMap } from "./types/DOMUtilsEvent";
 import { ParseHTMLReturnType, type DOMUtilsTargetElementType } from "./types/global";
-import { type UtilsWindowApiOption } from "./WindowApi";
+import type { WindowApiOption } from "./types/WindowApi";
 /**
  * 判断是否是元素列表
  * @param $ele
  */
 export declare const isNodeList: ($ele: any) => $ele is any[] | NodeList;
 declare class DOMUtils extends DOMUtilsEvent {
-    constructor(option?: UtilsWindowApiOption);
+    constructor(option?: WindowApiOption);
     /** 版本号 */
     version: string;
     /**
@@ -184,7 +185,7 @@ declare class DOMUtils extends DOMUtilsEvent {
      * DOMUtils.val(document.querySelector("input.xx"),true)
      * DOMUtils.val("input.xx",true)
      * */
-    val(element: HTMLInputElement | HTMLTextAreaElement | string | (HTMLInputElement | HTMLTextAreaElement)[] | NodeListOf<HTMLInputElement | HTMLTextAreaElement>, value: string | boolean | number): void;
+    val(element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | string | (HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement)[] | NodeListOf<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>, value: string | boolean | number): void;
     /**
      * 获取value属性值
      * @param element 目标元素
@@ -192,7 +193,7 @@ declare class DOMUtils extends DOMUtilsEvent {
      * // 获取元素textarea的值
      * DOMUtils.val(document.querySelector("textarea.xx"))
      * */
-    val(element: HTMLInputElement | HTMLTextAreaElement | string | (HTMLInputElement | HTMLTextAreaElement)[] | NodeListOf<HTMLInputElement | HTMLTextAreaElement>): string;
+    val(element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | string | (HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement)[] | NodeListOf<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>): string;
     /**
      * 获取value属性值
      * @param element 目标元素
@@ -201,7 +202,7 @@ declare class DOMUtils extends DOMUtilsEvent {
      * DOMUtils.val(document.querySelector("input.xx"))
      * DOMUtils.val("input.xx")
      * */
-    val(element: HTMLInputElement | HTMLTextAreaElement | (HTMLInputElement | HTMLTextAreaElement)[] | NodeListOf<HTMLInputElement | HTMLTextAreaElement>): boolean | string;
+    val(element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | (HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement)[] | NodeListOf<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>): boolean | string;
     /**
      * 获取元素的属性值
      * @param element 目标元素
@@ -275,6 +276,12 @@ declare class DOMUtils extends DOMUtilsEvent {
      * DOMUtils.addClass("a.xx","_vue_")
      * */
     addClass(element: DOMUtilsTargetElementType, className: string | string[]): void;
+    /**
+     * 判断元素是否存在className
+     * @param element
+     * @param className
+     */
+    hasClass(element: DOMUtilsTargetElementType, className: string | string[]): boolean;
     /**
      * 函数在元素内部末尾添加子元素或HTML字符串
      * @param element 目标元素
@@ -609,7 +616,7 @@ declare class DOMUtils extends DOMUtilsEvent {
      * @param option
      * @returns
      */
-    createDOMUtils(option?: UtilsWindowApiOption): DOMUtils;
+    createDOMUtils(option?: WindowApiOption): DOMUtils;
     /**
      * 获取文字的位置信息
      * @param $input 输入框

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

@@ -1,7 +1,7 @@
-import { UtilsWindowApiOption } from "./WindowApi";
+import { WindowApi } from "./WindowApi";
 /** 通用工具类 */
 declare const DOMUtilsCommonUtils: {
-    windowApi: UtilsWindowApiOption;
+    windowApi: WindowApi;
     /**
      * 判断元素是否已显示或已连接
      * @param element

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

@@ -1,5 +1,5 @@
 declare const DOMUtilsData: {
-    /** .on绑定的事件 */
+    /** .on添加在元素存储的事件 */
     SymbolEvents: symbol;
 };
 export { DOMUtilsData };

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

@@ -1,209 +1,10 @@
+import type { DOMUtils_Event, DOMUtils_EventType, DOMUtilsElementEventType, DOMUtilsEventListenerOptionsAttribute } from "./types/DOMUtilsEvent";
 import type { DOMUtilsTargetElementType } from "./types/global";
-import { UtilsWindowApiOption } from "./WindowApi";
-export type DOMUtilsEventObject<T extends Node> = Event & {
-    target: T;
-};
-export declare type DOMUtilsCreateElementAttributesMap = {
-    style?: string;
-    id?: string;
-    class?: string;
-    "data-"?: string;
-    type?: string;
-    [key: string]: any;
-};
-/**
- * 鼠标事件
- * + https://blog.csdn.net/weixin_68658847/article/details/126939879
- */
-export interface DOMUtils_MouseEvent {
-    click: MouseEvent | PointerEvent;
-    contextmenu: MouseEvent | PointerEvent;
-    dblclick: MouseEvent | PointerEvent;
-    mousedown: MouseEvent | PointerEvent;
-    mouseenter: MouseEvent | PointerEvent;
-    mouseleave: MouseEvent | PointerEvent;
-    mousemove: MouseEvent | PointerEvent;
-    mouseover: MouseEvent | PointerEvent;
-    mouseout: MouseEvent | PointerEvent;
-    mouseup: MouseEvent | PointerEvent;
-    hover: MouseEvent;
-}
-export type DOMUtils_MouseEventType = keyof DOMUtils_MouseEvent;
-/**
- * 鼠标事件
- */
-export interface DOMUtils_KeyboardEvent {
-    keydown: KeyboardEvent;
-    keypress: KeyboardEvent;
-    keyup: KeyboardEvent;
-}
-export type DOMUtils_KeyboardEventType = keyof DOMUtils_KeyboardEvent;
-/**
- * 框架/对象事件
- */
-export interface DOMUtils_Frame_Object_Event {
-    abort: Event;
-    beforeunload: Event;
-    error: Event;
-    hashchange: Event;
-    load: Event;
-    pageshow: Event;
-    pagehide: Event;
-    resize: Event;
-    scroll: Event;
-    unload: Event;
-}
-export type DOMUtils_Frame_Object_EventType = keyof DOMUtils_Frame_Object_Event;
-/**
- * 表单事件
- */
-export interface DOMUtils_FormEvent {
-    blur: Event;
-    change: Event;
-    focus: Event;
-    focusin: Event;
-    focusout: Event;
-    input: Event;
-    reset: Event;
-    search: Event;
-}
-export type DOMUtils_FormEventType = keyof DOMUtils_FormEvent;
-/**
- * 剪贴板事件
- */
-export interface DOMUtils_ClipboardEvent {
-    copy: ClipboardEvent;
-    cut: ClipboardEvent;
-    paste: ClipboardEvent;
-}
-export type DOMUtils_ClipboardEventType = keyof DOMUtils_ClipboardEvent;
-/**
- * 打印事件
- */
-export interface DOMUtils_PrintEvent {
-    afterprint: Event;
-    beforeprint: Event;
-}
-export type DOMUtils_PrintEventType = keyof DOMUtils_PrintEvent;
-/**
- * 拖动事件
- */
-export interface DOMUtils_DragEvent {
-    drag: DragEvent;
-    dragend: DragEvent;
-    dragenter: DragEvent;
-    dragleave: DragEvent;
-    dragover: DragEvent;
-    dragstart: DragEvent;
-    drop: DragEvent;
-}
-export type DOMUtils_DragEventType = keyof DOMUtils_DragEvent;
-/**
- * 多媒体（Media）事件
- */
-export interface DOMUtils_MediaEvent {
-    abort: Event;
-    canplay: Event;
-    canplaythrough: Event;
-    durationchange: Event;
-    emptied: Event;
-    ended: Event;
-    error: Event;
-    loadeddata: Event;
-    loadedmetadata: Event;
-    loadstart: Event;
-    pause: Event;
-    play: Event;
-    playing: Event;
-    progress: Event;
-    ratechange: Event;
-    seeked: Event;
-    seeking: Event;
-    stalled: Event;
-    suspend: Event;
-    timeupdate: Event;
-    volumechange: Event;
-    waiting: Event;
-}
-export type DOMUtils_MediaEventType = keyof DOMUtils_MediaEvent;
-/**
- * 动画事件
- */
-export interface DOMUtils_AnimationEvent {
-    animationend: AnimationEvent;
-    animationiteration: AnimationEvent;
-    animationstart: AnimationEvent;
-}
-export type DOMUtils_AnimationEventType = keyof DOMUtils_AnimationEvent;
-/**
- * 过渡事件
- */
-export interface DOMUtils_TransitionEvent {
-    transitionend: TransitionEvent;
-}
-export type DOMUtils_TransitionEventType = keyof DOMUtils_TransitionEvent;
-/**
- * 触摸事件
- */
-export interface DOMUtils_TouchEvent {
-    touchstart: TouchEvent;
-    touchmove: TouchEvent;
-    touchend: TouchEvent;
-    touchcancel: TouchEvent;
-    touchenter: TouchEvent;
-    touchleave: TouchEvent;
-}
-export type DOMUtils_TouchEventType = keyof DOMUtils_TouchEvent;
-/**
- * 其它事件
- */
-export interface DOMUtils_OtherEvent {
-    message: Event;
-    online: Event;
-    offline: Event;
-    popstate: Event;
-    show: Event;
-    storage: Event;
-    toggle: Event;
-    wheel: Event;
-    propertychange: Event;
-    fullscreenchange: Event;
-    DOMContentLoaded: Event;
-}
-export type DOMUtils_OtherEventType = keyof DOMUtils_OtherEvent;
-/**
- * 全部事件
- */
-export declare type DOMUtils_Event = DOMUtils_MouseEvent & DOMUtils_KeyboardEvent & DOMUtils_Frame_Object_Event & DOMUtils_FormEvent & DOMUtils_ClipboardEvent & DOMUtils_PrintEvent & DOMUtils_DragEvent & DOMUtils_MediaEvent & DOMUtils_AnimationEvent & DOMUtils_TransitionEvent & DOMUtils_TouchEvent & DOMUtils_OtherEvent;
-/**
- * 事件类型
- */
-export declare type DOMUtils_EventType = keyof DOMUtils_Event;
-/**
- * 元素上的events属性
- */
-export declare interface DOMUtilsEventListenerOptionsAttribute {
-    /**
-     * 自定义的ownCallBack
-     */
-    callback: () => void;
-    /**
-     * 属性配置
-     */
-    option: AddEventListenerOptions;
-    /**
-     * 用户添加的事件
-     */
-    originCallBack: () => void;
-    /**
-     * 子元素选择器
-     */
-    selector?: string;
-}
-export declare type DOMUtilsElementEventType = HTMLElement | string | NodeList | (HTMLElement | Window | Document | Element | typeof globalThis)[] | Window | Document | Element | null | typeof globalThis | ShadowRoot | EventTarget | ChildNode | Node;
+import type { WindowApiOption } from "./types/WindowApi";
+import { WindowApi } from "./WindowApi";
 export declare class DOMUtilsEvent {
-    windowApi: UtilsWindowApiOption;
-    constructor(windowApiOption?: UtilsWindowApiOption);
+    windowApi: typeof WindowApi.prototype;
+    constructor(windowApiOption?: WindowApiOption);
     /**
      * 绑定事件
      * @param element 需要绑定的元素|元素数组|window

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

@@ -1,19 +1,10 @@
-/**
- * 配置类型
- */
-export type UtilsWindowApiOption = {
-    document: Document;
-    window: Window & typeof globalThis;
-    globalThis: typeof globalThis | Window;
-    self: Window & typeof globalThis;
-    top: Window;
-};
+import type { WindowApiOption } from "./types/WindowApi";
 export declare class WindowApi {
     /** 默认的配置 */
     private defaultApi;
     /** 使用的配置 */
     private api;
-    constructor(option?: UtilsWindowApiOption);
+    constructor(option?: WindowApiOption);
     get document(): Document;
     get window(): Window & typeof globalThis;
     get globalThis(): typeof globalThis | Window;

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

@@ -0,0 +1,238 @@
+export type DOMUtilsEventObject<T extends Node> = Event & {
+	target: T;
+};
+
+export type DOMUtilsCreateElementAttributesMap = {
+	style?: string;
+	id?: string;
+	class?: string;
+	"data-"?: string;
+	type?: string;
+	[key: string]: any;
+};
+/**
+ * 鼠标事件
+ * + https://blog.csdn.net/weixin_68658847/article/details/126939879
+ */
+
+export interface DOMUtils_MouseEvent {
+	click: MouseEvent | PointerEvent;
+	contextmenu: MouseEvent | PointerEvent;
+	dblclick: MouseEvent | PointerEvent;
+	mousedown: MouseEvent | PointerEvent;
+	mouseenter: MouseEvent | PointerEvent;
+	mouseleave: MouseEvent | PointerEvent;
+	mousemove: MouseEvent | PointerEvent;
+	mouseover: MouseEvent | PointerEvent;
+	mouseout: MouseEvent | PointerEvent;
+	mouseup: MouseEvent | PointerEvent;
+	hover: MouseEvent;
+}
+export type DOMUtils_MouseEventType = keyof DOMUtils_MouseEvent;
+/**
+ * 鼠标事件
+ */
+export interface DOMUtils_KeyboardEvent {
+	keydown: KeyboardEvent;
+	keypress: KeyboardEvent;
+	keyup: KeyboardEvent;
+}
+export type DOMUtils_KeyboardEventType = keyof DOMUtils_KeyboardEvent;
+/**
+ * 框架/对象事件
+ */
+export interface DOMUtils_Frame_Object_Event {
+	abort: Event;
+	beforeunload: Event;
+	error: Event;
+	hashchange: Event;
+	load: Event;
+	pageshow: Event;
+	pagehide: Event;
+	resize: Event;
+	scroll: Event;
+	unload: Event;
+}
+export type DOMUtils_Frame_Object_EventType = keyof DOMUtils_Frame_Object_Event;
+/**
+ * 表单事件
+ */
+export interface DOMUtils_FormEvent {
+	blur: Event;
+	change: Event;
+	focus: Event;
+	focusin: Event;
+	focusout: Event;
+	input: Event;
+	reset: Event;
+	search: Event;
+}
+export type DOMUtils_FormEventType = keyof DOMUtils_FormEvent;
+
+/**
+ * 剪贴板事件
+ */
+export interface DOMUtils_ClipboardEvent {
+	copy: ClipboardEvent;
+	cut: ClipboardEvent;
+	paste: ClipboardEvent;
+}
+export type DOMUtils_ClipboardEventType = keyof DOMUtils_ClipboardEvent;
+
+/**
+ * 打印事件
+ */
+export interface DOMUtils_PrintEvent {
+	afterprint: Event;
+	beforeprint: Event;
+}
+export type DOMUtils_PrintEventType = keyof DOMUtils_PrintEvent;
+
+/**
+ * 拖动事件
+ */
+export interface DOMUtils_DragEvent {
+	drag: DragEvent;
+	dragend: DragEvent;
+	dragenter: DragEvent;
+	dragleave: DragEvent;
+	dragover: DragEvent;
+	dragstart: DragEvent;
+	drop: DragEvent;
+}
+export type DOMUtils_DragEventType = keyof DOMUtils_DragEvent;
+
+/**
+ * 多媒体（Media）事件
+ */
+export interface DOMUtils_MediaEvent {
+	abort: Event;
+	canplay: Event;
+	canplaythrough: Event;
+	durationchange: Event;
+	emptied: Event;
+	ended: Event;
+	error: Event;
+	loadeddata: Event;
+	loadedmetadata: Event;
+	loadstart: Event;
+	pause: Event;
+	play: Event;
+	playing: Event;
+	progress: Event;
+	ratechange: Event;
+	seeked: Event;
+	seeking: Event;
+	stalled: Event;
+	suspend: Event;
+	timeupdate: Event;
+	volumechange: Event;
+	waiting: Event;
+}
+export type DOMUtils_MediaEventType = keyof DOMUtils_MediaEvent;
+
+/**
+ * 动画事件
+ */
+export interface DOMUtils_AnimationEvent {
+	animationend: AnimationEvent;
+	animationiteration: AnimationEvent;
+	animationstart: AnimationEvent;
+}
+export type DOMUtils_AnimationEventType = keyof DOMUtils_AnimationEvent;
+
+/**
+ * 过渡事件
+ */
+export interface DOMUtils_TransitionEvent {
+	transitionend: TransitionEvent;
+}
+export type DOMUtils_TransitionEventType = keyof DOMUtils_TransitionEvent;
+
+/**
+ * 触摸事件
+ */
+export interface DOMUtils_TouchEvent {
+	touchstart: TouchEvent;
+	touchmove: TouchEvent;
+	touchend: TouchEvent;
+	touchcancel: TouchEvent;
+	touchenter: TouchEvent;
+	touchleave: TouchEvent;
+}
+export type DOMUtils_TouchEventType = keyof DOMUtils_TouchEvent;
+/**
+ * 其它事件
+ */
+export interface DOMUtils_OtherEvent {
+	message: Event;
+	online: Event;
+	offline: Event;
+	popstate: Event;
+	show: Event;
+	storage: Event;
+	toggle: Event;
+	wheel: Event;
+	propertychange: Event;
+	fullscreenchange: Event;
+	DOMContentLoaded: Event;
+}
+export type DOMUtils_OtherEventType = keyof DOMUtils_OtherEvent;
+
+/**
+ * 全部事件
+ */
+export declare type DOMUtils_Event = DOMUtils_MouseEvent &
+	DOMUtils_KeyboardEvent &
+	DOMUtils_Frame_Object_Event &
+	DOMUtils_FormEvent &
+	DOMUtils_ClipboardEvent &
+	DOMUtils_PrintEvent &
+	DOMUtils_DragEvent &
+	DOMUtils_MediaEvent &
+	DOMUtils_AnimationEvent &
+	DOMUtils_TransitionEvent &
+	DOMUtils_TouchEvent &
+	DOMUtils_OtherEvent;
+
+/**
+ * 事件类型
+ */
+export declare type DOMUtils_EventType = keyof DOMUtils_Event;
+
+/**
+ * 元素上的events属性
+ */
+export declare interface DOMUtilsEventListenerOptionsAttribute {
+	/**
+	 * 自定义的ownCallBack
+	 */
+	callback: () => void;
+	/**
+	 * 属性配置
+	 */
+	option: AddEventListenerOptions;
+	/**
+	 * 用户添加的事件
+	 */
+	originCallBack: () => void;
+	/**
+	 * 子元素选择器
+	 */
+	selector?: string;
+}
+
+export declare type DOMUtilsElementEventType =
+	| HTMLElement
+	| string
+	| NodeList
+	| (HTMLElement | Window | Document | Element | typeof globalThis)[]
+	| Window
+	| Document
+	| Element
+	| null
+	| typeof globalThis
+	| ShadowRoot
+	| EventTarget
+	| ChildNode
+	| Node;

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

@@ -0,0 +1,10 @@
+/**
+ * 配置类型
+ */
+export type WindowApiOption = {
+	document: Document;
+	window: Window & typeof globalThis;
+	globalThis?: typeof globalThis | Window;
+	self?: Window & typeof globalThis;
+	top: Window;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/domutils",
-  "version": "1.3.7",
+  "version": "1.4.0",
   "description": "使用js重新对jQuery的部分函数进行了仿写",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",